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THE DK SCREEN-SHOT PROGRAMMING SERIES 
Books One and Two in the DK Screen-Shot Programming Series 
brought to home computer users a new and exciting way of 
learning how to program іп BASIC. Following the success of this 
completely new concept in teach-yourself computing, the series 
now carries on to explore the speed and potential of machine-code 
graphics. Fully illustrated in the unique Screen-Shot style, the 
series continues to set new standards in the world of computer 
books. 


BOOKS ABOUT THE ZX SPECTRUM+ 
This is Book Four in a series of guides to programming the ZX 
Spectrum+. It contains a complete machine-code sprite-programming 
course for the Spectrum+, and features its own sprite editor which 
enables you to design and store sprites directly from the keyboard. 
Together with its companion volumes, it builds up into a complete 
programming and graphics system. 


ALSO AVAILABLE IN THE SERIES 
Step-by-Step Programming for the Commodore 64 
Step-by-Step Programming for the BBC Micro 
Step-by-Step Programming for the Acorn Electron 
Step-by-Step Programming for the Apple Ile 
Step-by-Step Programming for the Apple Ис 














PIERS LETCHER 
After graduating with a degree in Computer Systems, Piers 
Letcher has worked in many areas of the computer industry, from 
programming and selling mainframes to designing and marketing 
educational software. He was Peripherals Editor of Personal 
Computer News until May 1984 and has since written a guide to 
peripherals and a number of other books for popular home micros. 
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"The Sinclair Spectrum is one of the most popular micro- 
computers ever produced. One reason for its success has 
been its remarkable ability to produce graphic displays 
rivalling those produced by much larger computers 
designed only ten or fifteen years ago, However, graphics 
programming in BASIC under-utilizes the Spectrum. To 
produce the kind of displays seen in commercially avail- 
able games, you need to use machine code as well as 
BASIC. 


What is machine code? 

The heart of the Spectrum, the Z80 central processor, 
cannot understand BASIC. A BASIC program must first 
be translated into a simpler language that the machine 
can understand (hence the term “machine code"). This 
code is in the form of binary 1s and Os. Before the 
processor can execute a BASIC program line, all 
keywords and variables are first converted to machine- 
code instructions. 

BASIC is an example of what is known as an “inter- 
preted”, as opposed to a “compiled”, language — that is, 
it is executed by the central processor line by line rather 
than as a complete program. While an interpreted 
language is easier to use, it is also slower in execution. By 
writing programs in machine code, you can miss out the 
BASIC interpreter altogether. In addition, machine code 
allows you to utilize many features of your Spectrum 
which cannot be reached from BASIC, so that you can 
therefore achieve far more impressive results than would 
ever be possible from the simpler, but more restrict 
BASIC. You can get an idea of how much faster machine 
code is by seeing the time taken for the programs in this 
book to run. 





Disadvantages of machine code 

Given all the advantages of machine code in both speed 
and flexibility, why not ignore BASIC and use machine 
code all the time? The answer is simply convenience. 
Using machine code is time-consuming, difficult and 
frustrating, and attempting to write your own codeis only 
for the expert. When you see machine-code listings, they 
are usually in a “disassembled” form, thatis, with some of 
the numbers translated into mnemonics such as LD for 
LOAD, and JP for JUMP. But a special disassembler 
program is required simply to give you a machine-code 
listing in this form, and these mnemonics are themselves 
far from simple, Using machine code even the simplest 
operations in BASIC, such as drawing a line on the 
screen, require many lines of programming. In addition, 
machine code has no error-trapping routines such as 
those in BASIC. If a mistake is made when keying in a 
BASIC program, the program will not be lost (although 
the program may refuse to RUN at some point); in 





machine code, without error-trapping routines, а 
mistake will probably cause the Spectrum to crash, with 
the result that both the program and its DATA are lost. 


The solution 

This book combines the advantages of machine code 
with the convenience and simplicity of BASIC. This is 
done by giving the machine code in the form of ready- 
made and tested routines, which you can then use in 
your BASIC programs. The machine code is shown as 
DATA statements in BASIC, which means it isn't 
necessary for you to understand anything about 
machine code to be able to use the routines. The DATA 
is given in the form of decimal numbers, rather than in 
binary or hexadecimal (to base 16), so that the machine 
code is in the form most convenient for you to key in. 





The machine-code routines 

The screen below shows an example of a machine 
code routine (the double vertical sprite routine, FNj, 
given on page 17). 





7450 L b ; LET i-325: DET 
250: RESTORE 7460 

7451 FOR ісд TO 1-1: READ а 
7452 POKE (b+il,a LET z-z*a 
7453 NEXT i “ 

7454 LET z-INT (((z^l) -INT (z^) 
x0 

7455 READ а: IF a<>z THEN PRINT 














Each routine in the book is shown like this, in the 
form of a BASIC program. The machine code is con- 
tained as a series of DATA statements in lines 7460 
onwards. At the beginning of the routine, in lines 7450 
to 7455, there are a few lines of BASIC. This is a loader 
program; variable b tells the computer where in 
memory to begin loading the routine, and variable | the 
number of bytes in the routine. When the loader routine 
is RUN, this routine is placed in memory from address 
52100 onwards, and has a total length of 225 bytes. 

As shown here, of course, the routine is simply a list of 
numbers, and has no visible meaning. These numbers 
are the ready-tested and assembled machine code which 
has then been converted to a sequence of decimal 
numbers. Each number corresponds to a single 
instruction or item of DATA required by the routine; 











hence, all the numbers have values between 0 and 255, 
the maximum range of a byte. All you need to know 
about the routine is what it does and what information it 
requires so that you can call it correctly from your 
BASIC program. 

All the routines in the book are defined as functions. 
Each function is individually coded by the letters a to о; 
a complete list of functions is given on pages 62-63. 
Demonstration BASIC programs can be found on 
the same page as each routine; these give you an 
indication of the kind of displays which are possible 
using the machine code. 


How to use the routines 
To use any program in this book, simply key in a 
machine-code routine together with a BASIC program 
which demonstrates its use. You will find full details of 
how to do this on pages 8-9. When you RUN the program, 
you will begin to се the true power of your Spectrum. 
As you progress through the book and the range of 
routines grows, the BASIC programs grow too by 
calling several routines to produce increasingly complex 
displays. By keying in each routine, and then SAVEing 
it onto cassette or Microdrive, you will have a sophisti- 
cated but flexible graphics capability at your fingertips. 


The programs in use 

Atypical program from this book (the unicycle program 
on page 23) contains two details which will be 
unfamiliar to BASIC programmers who have not used 
machine code before: 








First, you will see in line 10 a DEF EN statement, which 
is used to instruct the computer that a machine-code 
routine with two parameters (x and y) is located at 
address 52100 in memory. You will also notice two 
RANDOMIZE FN commands (lines 110 and 120). 
These are the calls to the double vertical sprite routine, 
and the numbers in brackets which follow them are the 





parameter values to be passed to the machine-code 
routine (in this case, the start co-ordinates of the sprite, 
its direction, how far it is te move and various other 
instructions). When RUNning, the program is carried 
out by the computer in this way: 





С НОУ THE UNICYCLE PROGRAM WORKS | 














10 DEF ENj (routine 
name and address) 
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100 sets border colour 


aa ст 


ПОҚАМОМІ2Е 
FN} 
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120RANDOMIZE 
ЕМ 


сее е 


130 repeat sequence 










sprite printed from co- 
_ ordinates 15,70 















sprite printed from co- 
ordinates 220,70 — 


























program, and on the right you can see the machine-code 
routines, called twice using a RANDOMIZE FN 
statement. You will see from the diagram that the 
machine-code is used here very much as a subroutine 
would be used in BASIC, with variables passed to the 
routines each time they are called. 


What the routines do 
The routines in this book free you from the limitations 
of programming in BASIC. By using the machine-code 
given here, you will be able to create and control sprites, 
to control them on the screen and to animate them, and 
to scroll both the entire screen and defined areas of it. 
In addition, two of the later routines provide an intro- 
duction to one of the most exciting aspects of machine- 
code graphics: interrupt-driven routines, which operate 
independently of BASIC, and which enable you to 
program your Spectrum to carry out several tasks 
simultaneously. 


Creating and editing sprites 

To make sprites even easier to use, a directory of over 
200 sprites is included from pages 36 to 61. These 
sprites can be keyed in and then edited with the sprite 
editor routine and program, given on pages 11 to 13. 
Using the sprite editor, you will find it easy to make your 
own versions of the sprites given in this book. Using 
single-key commands, for example, you can invert the 
sprites, make them face another direction, or turn them 
upside down. 
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THE MACHINE CODE 





The machine-code routines in this book can easily be 
incorporated into your BASIC programs without you 
having to understand the intricacies of how they work. 
Simply choose a program from this book, and follow the 
steps given here. 


1: CLEAR memory 
As soon as you switch on your Spectrum, type CLEAR 
49000. This command resets RAMTOP, the top of the 
area in memory free for BASIC programs, and ensures 
that BASIC programs cannot overlap with the machine 
code stored in memory from 49200 upwards. Now you 
can safely use NEW to delete BASIC programs without 
losing any of the machine code in memory. 
Remember to use CLEAR before loading machine 
code, since this command erases whatever is in memory 
above the specfied address. 


2: Load the machine code 
Now type in whatever machine-code routines are 


Address in memory at which 
routine is located 





Start address 54190 Length 75 bytes— 


required by the BASIC program. After keying in the 
routine, RUN the short BASIC program which accom- 
panies it; this loads the code into memory. If you keyed 
inthe DATA correctly, you will see an “OK” message on 
the screen; if not, you will see a couple of question 
marks. In this case, look again at what you have typed in 
to trace the mistake. 


3: SAVE the routine 
When you are sure you have keyed in the routine 
| correctly, SAVE it onto cassette or Microdrive. Always 
SAVE machine code before using it, to minimize the risk 
| of losing everything you have keyed in. When BASIC 
errors occur, an error message is usually produced but 
the program is not lost. Machine-code routines, how- 
| ever, do not generally have error-trapping facilities, and 
afaultin the code will as often as not cause the Spectrum 
to crash — deleting everything in memory. 

The machine code can be SAVEd in two ways: either 
in the form of DATA statements like any other BASIC 





Routine title 







Name of routine 


Number of bytes in memory 
taken up by routine 









Number of parameters used 


by the routine, and letters 
used to describe these 
parameters 


Other routines called Sprite editor routines (FNa-FNe). 


wrar it does Prints a single spriteonthescreenataspecited | 
point. 


Using the routine This routine displays any single sprite from 
the sprite buffer. The routine does not move the sprite. Note 
that if the sprite is too far to the right of the screen it will 
reappear one character below on the left-hand side of the 
Screen, since the Spectrum PRINT routine is used in the transfer 
of memory-ta screen 
















| specify print position (x<29, y<21) 
n specifies number of sprite (1-10) 

















BASIC loading routine for the 


machine-code DATA 








Start address for POKEing 
DATA 


POKEs byte value a into 
location (b-Hi) 






Purpose of routine 





Points to note when using the 
routine 





t the parameters do 





Maximum and minimum 
values of parameter to ensure 
the routine does not plot off- 
screen points 


Number of machine-code 











Start of machine-code DATA 





= T bx meta k digit) 
Тева RESTORE 2920 Ет 0 те-—тЕт bytes (without check digit 
7901 FOR і-Ө TO 1-1. READ а 
7395 KE (b+i),3 LET z-z*a = 

NEXT i Calculates check digit z 

7904 LET г-вме- с тт) -INT (2/4, 
ща 
7905 READ з- I= e-z THEN PRINT i 
7995 READS READS next DATA item, 


the routine check digit; if this 
is not the same as z, two 
question marks are PRINTed 
to show a mistake has been 
made 











10 DATA :92,1,4 

7911 DATA 6,1,8 

7915 Бата 4,257,823 

7313 бата 11,9.126,50 
7812 DATA 11,123,230,24 
7815 бата г, 13 123,2за 














listing, or, after you have loaded it into memory, as a 
block of code. To save machine code, type: 


SAVE “routine name” CODE start address, length in 
bytes 





you opt to use RESTORE instead of RANDOMIZE 
then be especially careful if there are any READ or 
DATA statements in your program. 





The start address and length are given at the top of each 
machine-code box. The diagram on the facing page 
shows how this information is displayed. 


4: LOAD a BASIC program 

With the machine-code routine in memory, you can now 
use it in a BASIC program. DEF FN statements are 
used to tell the Spectrum the whereabouts of the routine 
in memory, and what information it requires. 


Using functions 

A machine-code routine can be called simply by 
specifying its start location, like this: 

10 RANDOMIZE USR 54100 


Aline like this in a BASIC program, however, is not very 
informative. It tells you neither what the routine does, 
nor how many parameters the routine may require 
when called. This information could be РОК Ед into the 
appropriate memory locations — but the consequences 
of a mistake could be disastrous. Much more reliable is 
to pass information to the routines using a BASIC 
function. Functions on the Spectrum are identified by a 
single letter, and are followed by parameters in 
brackets. When you define the name and location ofthe 
function in your program, you must also specify the 
parameters, if any, which are to be passed to the routine. 
For example, the sprite print routine, FNf, requires 
three parameters: 

10 DEF EN f(x,y,n)-USR 54100 

Which letters are used after DEF EN is not important; 
their function is only to tell the computer the number of 
parameters which will follow the routine call ina BASIC 
program. 

A machine-code function can be called from BASIC 
in two main ways, both of which require you to combine 
the keywords FN or USR with a BASIC keyword. The 
method used generally in this book is with the keyword 
RANDOMIZE. Thus, 


20 RANDOMIZE EN f(10,10,1) 


would display the first sprite from the sprite buffer in 
memory at co-ordinates 10,10. Note that using 
RANDOMIZE also resets the random number 
generator with a new seed; this may cause problems if 
you are also using a random function in your program. 

‘The second word you can изе to call machine code is 
RESTORE. However, RESTORE also resets the 
pointer to DATA statements when you use it — which is 














of course the purpose of the RESTORE statement. If | 


QUESTIONS ANDANSWERS 











What if I make a mistake in keying in? 

Don't panic! Nobody keys in long lists of numbers 
without making any mistakes. A check routine is 
included with each machine-code routine to warn you if 
you made any mistakes in keying in the DATA. This 
routine compares the DATA you have entered with a 
check number, which is placed by itself on the last 
DATA line of each routine. 

After the loading program has POKEd the DATA 
numbers into memory, it looks to see if the check digit is 
the same as the one currently calculated. If the two 
numbers are different, the program prints two question 
marks to show an error has been made. If this happens, 
look through the numbers you have typed in to find the 
mistake. Having corrected the error, you may still find 
that the routine fails to load correctly; look to see if you 
have made more than one error. 


Can I start anywhere in the book? 

Yes, you can start on any page, but obviously when you 
key in a program it will not RUN unless the machine- 
code routine it calls is present in memory. Check before 
you begin if the program you want to RUN calls any 
machine-code routines you haven't already keyed in. 
If you key in all the routines in this book as BASIC 
DATA statements, you will find there isn't room in 
memory to store them all. By loading each routine as 
machine code as soon as you have keyed it in, you can 
avoid this happening. In the form of machine code, you 
can, of course, use any of the Book Four routines 
together, as well as any routines from Book Three - the 
routines will not overlap in memory. 


Can I adapt the BASIC programs? 

Yes. You can edit the BASIC programs in any way you 
want to produce different displays, and you will find 
suggestions for variations throughout the book. One 
suggestion, though, if you are going to experiment with 
unusual or off-screen values for the machine-code 
parameters, is to SAVE what you have keyed in before 
experimenting. This will prevent you from losing hours 
of work at the keyboard! 


Can I adapt the machine-code routines? 

Yes, but at your own risk! Without a good under- 
standing of machine code, it is highly unlikely that you 
will be able to alter any of the routines successfully. 
Much more probable is that the Spectrum would crash, 
with the result that both program and code are wiped 
from memory. 























WHAT ARE 











SPRITES? 





Most of the computer graphics you have created up to 
now have probably been stationary rather than moving, 
though you will have seen all sorts of moving graphics in 
arcade games and in commercial Spectrum software. 
Before you can create moving graphics for yourself, 
however, it is necessary to look at the ideas behind 
movement. 


What is movement? 
You tell something is moving if its position changes 
relative to something else. You know a train going past a 
window is moving, because the window is still. This book 
is about creating movement, and displaying moving 
objects. The objects to be moved are called sprites: objects 
which can move over a background without destroying it. 
The diagram below shows a single sprite.. 
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Creating movement | 
The problem in creating movement is not so much in 
making something move as in making it move smoothly. 
You probably know that one way of getting something to 
move in BASIC on your Spectrum is to PRINT an object 
on the screen, wipe it off again, and PRINT it again in 
quick succession. This method has several disadvantages, 
the most important of which you will notice as soon as you 
try it out — the movement looks jerky. This is because 
there will be a space of one character between each 
position where the object is PRINTed. The other problem | 
with BASIC is that it is simply not fast enough in 
operation to be used for smooth movement. 

The jump of eight pixels between each position of the 
object is easily visible, and the obvious solution is to print 
the object every pixel rather than every character. This is 
easier said than done, however, since printing objects 
across pixel boundaries requires the step from BASIC to | 
machine code. Using machine code will also give you the 
increase in speed which is necessary for implementing 
smooth movement. 

To use movement effectively you must first make a few 








decisions on what you plan to move around the screen. 
Firstly, you must decide the size of object you want to 
move. The most obvious choice is a single character (8 by 
8 pixels), but this looks very small in screen displays. On 
the other hand if you pick a size which is too large you will 
havethe problem of trying to move thousands of pixels at 
the same time, resulting in a very jerky effect. The 
solution presented here is to use a shape 24 pixels wide by 
21 pixels deep — or in character terms a little under three 
by three characters. To create a practical illusion of 
movement you must also make sure that the object to be 
moved does not destroy the background over which it 
passes. 





Ways of implementing sprites 

Some computers have sprites built into them as part of the 
machine hardware. The Commodore 64, for example, 
has a sophisticated chip dedicated to the implementation 
of sprites, since the method used to display them is so 
complicated. The chip works by saving the area of the 
screen underneath the sprite position (a block 24 by 21 
pixels), printing the sprite, wiping off the sprite, printing 
thesprite one pixel further on and then replacing that part 
of the background which was uncovered by the 
movement. Though it would be possible to implement this 
process on the Spectrum, it would be very slow, or altern- 
atively it would require a very long routine with many 
hundreds of bytes of DATA to be typed in. 

An alternative method of implementing sprites uses a 
technique that you have probably used quite a lot already, 
which is to print onto the screen using Exclusive/OR 
plotting. If vou do this with sprites you do not have to 
worry about the background, as it will remain unchanged, 
with the sprite appearing to move across the background 
without interference. 








SPRITE SCREEN DISPLAY 


























In order to use sprites, you need some means of creating 
them, and you need а location in memory where a number 
of them can be stored for future reference. This is the 
purpose of the sprite editor program. The program allows 
you to design and edit sprites on the screen, and stores 
them in memory for use by the sprite routines. Each sprite 
consists of 504 pixels, and is stored in 63 bytes of the 
Spectrum memory. 

The sprite editor allows ten sprites to be defined at a 
time, and gives you the option of transferring sprites from 
one location in the sprite buffer to another. In addition, 
sprites can be flipped horizontally and vertically, and 
inverted (by switching the ink and paper attributes). The 
program also allows you to load in previously edited 
sprites from tape, and to save the current batch to tape for 
future use. 

The sprite editor is a combination of BASIC and 
machine code. The code comprises six different routines, 








all linked together. The purpose of each routine is 
explained below. 


The sprite editor routines 

Routine FNa, at address 54200, is the base routine for the 
editor. It converts the large grid on the screen to the small 
display of the current sprite you sce on the right. The 
current sprite is temporarily stored in a buffer, and the 
routine converts each dot in the buffer to a square on the 
screen. 

When you want to save the current sprite, you have to 
decide which of the ten sprite positions you are saving to. 
A routine at 54317 transfers the sprite stored in the buffer 
to the appropriate location in the sprite table in memory. 
Routine FNb, at address 54353, carries out the reverse of 
this operation, transferring a sprite from its position in the 
sprite table to the sprite editor buffer. Routine FNa is then 
called again to display the sprite. 
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The first two routines in the sprite editor enabled you to 
draw, load and save sprites. The remaining sprite routines 
have been written to give you the means of manipulating 
the sprite you have drawn. The effect they have on the 
sprite is shown in the displays here. Each routine is called 
by a keypress. Thus, when CAPS SHIFT and I are 


SPRITE EDITOR PROGRAM CONTD. 
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pressed together, a routine is called to invert every pixel of 
the sprite. To change the direction in which the sprite is 
facing, routine FNe at address 54436 is used, called by 
pressing CAPS SHIFT and R. Finally, to turn the current 
sprite upside down, routine FNfis used (called by pressing 
CAPS SHIFT and U). 


The BASIC editor program 
The BASIC controlling program (shown on this page and 
on page 11) works as follows. Line 110 calls a subroutine 
at line 1200 to draw the grid on the screen (a simple series 
of lines). Line 120 calls a section of the program which 
prints the menu to the right of the grid. From this section 
blocks of the program at lines 1000, 1100 and 1130 are 
called as required. Lines 1000-1020 wipe the menu off the 
right-hand side of the screen. Lines 1100-1110 save the 
current sprite table to tape, and return control to the start 
of the program. A BEEP is heard whenever a sprite is 
savedin memory. Lines 1130-1140 load a new sprite table 
from tape into memory. If neither 1100 or 1130 is called, 
control returns to line 130. 

Line 150 prints a sprite on the screen. Lines 180-210 
accept a keypress and check ifit is one of the functions I, К 
or U. If so, the relevant machine-code routine is called. If 
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FNa-e 


Start addresses 54200,54353,54422,54436,54482 
Length 355 bytes 

What they do The routines allow the user to design and edit up 
to ten sprites, and save them for use by later routines. 


Using the routines The routines work in conjunction with a 
BASIC program shown on page 11. Editing the current sprite is 
controlled by the 5, 6, 7 and 8 keys; used with the shift key, 
pixels are inked in; used without, pixels are unset or, if set, 
Changed to paper. The current sprite can be inverted (CAPS 
SHIFT and |), turned to face the other direction horizontally 





the keypress is CAPS SHIFT and Z, control goes to the 
short sequence at 480 to display the menu again. Lines 
250 to 280 do the work of editing the sprite, The sub- 
routine at line 1160 is called from this section. Notice how 
line 1160 divides the address to be saved into two parts, 
since 16 bit addresses will not fit into a single byte. 





MANIPULATING THE CURRENT SPRITE 











(CAPS SHIFT and R), or turned upside down (CAPS SHIFT and 


U). 

Sprites are stored in a table from location 54600. Previously 
defined sprites may be loaded from tape, altered, and then 
saved as a new selection. When you save the sprite table, 
remember that all ten sprites are saved, not just the one you 
have most recently been editing. 
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DISPLAYING SPRITES 





Once your sprites are defined it is very useful to be able 
to see what they look like on the screen. Obviously this 
can be done using the sprite-handling routine, but it is 
very hard to examine a sprite with a critical eye while itis 
moving across the screen! To avoid this problem, and 
also to give you the chance of looking at the shapes and 
designs of several sprites at once, the sprite print 
routine, FNf, has been provided. 

This routine prints a sprite from the sprite buffer onto 
the screen at a specified position. Since any of the sprites 
can be printed at any position on the screen you can use 
the routine to preview the sprites you have designed, 
and it is at this stage that you can decide the best sort of 
starting and finishing positions for the sprites when they 
come to be used. 

You can also use the routine to preview the effects of 
animation by calling the routine repeatedly to print 
sprites in an animation sequence on top of one another. 














SPRITE DISPLAY PROGRAM. 


DEF FM FC 
BORDER 4: 

FOR n=1 TO 10 

FOR коз TO 5 

RANDOMIZE FN f(n#3-3, (k#4) -= 


NEXT k 
NEXT n 

PAUSE e 

CLS 

RANDOMIZE FN f(10,10,9) 


PAUSE 1 
RANDOMIZE FN f(10,10,20) 
PAUSE 10 
со та 51а 





са 


cn 
























tal 


Ще 


езера 

















This will give you an idea of how effective the animation 
is going to be, as well as allowing you to make any 
changes to the sprites before you work out the 
animation in detail. 


How sprites are stored 

Before examining the machine-code routine it is 
important to understand how sprites are stored in 
memory. As you know, a sprite table which stores ten 
sprites can be found at location 54600 onwards in 
memory. A 24 by 21 sprite has 504 elements (24x21), 
and since any of these elements can have an ink 


information need to be stored away for each sprite. 
Each sprite requires 63 bytes of memory (since there are 
eight bits in a byte) and, as all ten sprites are stored one 
after the other, they take up a total of 630 bytes. 
Each sprite is arranged in memory as shown in the 
diagram below. Numbers correspond to the byte 
numbers (0-63), and the ls and Os represent the 


individual bits. 





Spritesare stored as binary numbers іп 63 bytes (504 bits) of memory. 
‘The Isand Os corres] tosetand unset pixels respectively on the 
sprite diagram shown underneath. 


attribute either set or not set, this means that 504 bits of 















1 000001000020000001000000 
25 000000200000000020000000 
48 000000100000000010000000 
73 010000110010100110000100 
97 0010000100010001000012020 

howmemory 13, 555369916011100195910050 

bits are 14$ 000100011011101100010000 

set 160 000111001191011001110000 
193 000001110011100111000000 
27 000000011111111100000090 
за 020000000021200000000000 
265 000000111111111119000000 
289 000011100211110011200000 
333 000210022211112100110000 
33: 000100110111110110010090 
161 001000100011100010001000 
ds 001000100001000010001000 
409 001001000000000002001000 
433 0000010000000000012000000 
457 000010000000000000100000 
ав: 000010000000000000100000 

sprite 

diagram 











The BASIC program 

The program on this page shows the contents of a sprite 
buffer, containing ten different sprites, displayed on the 
screen. The program calls the sprite print routine five 


times in a loop, to display the sprites down the screen as 
well as across it. 





| Start address 54100 L Length 75 bytes 

Other routines called Sprite editor routines (FNa-FNe). 
E it does Prints a single sprite on the screen at a specifed 
poin 


Using the routine This routine displays any single sprite from 
the sprite buffer. The routine does not move the sprite. Note 
that if the sprite is too far to the right of the screen it will 
reappear one character below on the left-hand side of the 
screen, since the Spectrum PRINT routine is used in the transfer 
of memory to screen. 










































[5 ... DEFFNf(cyn) _ ini 
specify print position (х< 29, у<<21) 

n RI specifies number of sprite (1-10) 

7900 LET b-s4100. LET 

то RESTORE 7910 

7901 е! 120 O Х-д RERD 

2892 POKE (ь%:).4 LET z-z*a 
7903 E X 

2902 LET z-INT ((i(z71)-INT (ш/а) 
) #4) 

7905 READ а ТЕ зоо: THEN PRINT 
eae STOP 

7910 DATA 42 1 /92,2,4 

7911 DATA 0,9,46,1,6 

7918 DATA @,3,94,237, 83 

7913 DATA 14 211,9,126,50 
7914 DATA 150:211.123,230,24 
2915 сата 24 64,103,123,230 
7916 CATA ?, 3,31,31,31 

7917 CATA 31 30,111,54,146 
2918 CATA 21 150,211,71 
7919 DATA 17 33,9 

7920 CATA 21 6,253,237 
7921 CATA 351 11,195,1 
7922 CATA 21 .174.72,13 
2923 рата 14 оа 

7924 DATA се е,а 














How the program works 

Line 10 defines the sprite print routine, which has three 
parameters: the x,y screen co-ordinates at which the 
sprite is to be printed, and the number of the sprite (from 
the ten sprites stored in the sprite table). Lines 90 and 
180 set up loops to print the sprites. Line 190 prints the 
sprite, using a combination of the two loop variables to 
define the x,y co-ordinate. 

Lines 300 to 330 show how animation can be 
achieved using a print routine. A left and right mirror 
image of a single sprite are printed one after the other to 
produce a simple animation effect. You could produce 
more complex animation in this way; the only limitation 
to the method is the amount of time it takes to define 
sprites, although the animation in this program can also 
be speeded up substantially by leaving out the PAUSE 
statements. Of course, the other drawback is that you 
cannot move the sprite around the screen using this 
method. 
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Now that you have routines to create sprites and display 
them on the screen, you need a routine which makes the 
sprites change position. The routines introduced here 
enable you to get your sprites moving on the screen. 


The master sprite routine 
"This routine enables you to move simple (that is, not 
animated) sprites. The routine has no title since it is 
always used together with the sprite-controlling 
routines in this book; by itself, the routine does nothing. 
When you use a sprite, it is this routine which causes the 
sprite to move across the screen in the required way. 
The main job of the routine is to print a sprite on the 
screen using Exclusive/OR printing, wipe it off, and 
print it again one pixel away until the program or 
routine asks the sprite to stop moving. 

The routine has been programmed to work whether it 
has been called by a routine which is working within 
BASIC (a normal routine) or by one working indepen- 
dently of BASIC (an interrupt-driven routine). 












7830 DATA 21,8,221,94,0 
7831 бата 221,06,21,221,78 
7832 DATA 42,35,35,126,169 
- = — 7833 DATA 119,43,126,170,119 
Ts Бата E 
а И » 78, 
Star address Ди Length 365 bytes 2836 рата 35,36,124 2838,7 
| i в „2 „8, ^ 
а loes Used in conjunction with the sprite-handling $892 DATA 29209 4m 62 2 
routine (he) this routine takes a sprite from the sprite table at 7839 DATA 147,128,71,205,177 
location 54600 and moves it across the screen. 7840 DATA 34,24,205,229,213 
2541 BATA 287:943,521.2254292 
+ " 2 n 241,2 21 „2 
Using the routine This routine must always be used together | 2849 DATA 277,24,282:815: 22а 
with the other sprite routines given іп this book; if used by itself, gees ERTO refer pui] 
i 7846 DATA 221,94,0,221,86 
you will not see anything happen on the screen. Whenever 2846 ӘНІН 2214221:.24.32.B 
sprites are used, the master sprite routine is called by the other 7848 DATA 1,175,203,27, 203 
routines to do the work of moving the sprite. ESAS OPTA: Ales sees din 
7850 DATA 247,35,35,35,71 
7851 DATA 126,160,196,33,211 
7855 DATA 126,165,119,43,126 
7853 бата 151,196.323,211; 126 
7854 DATA 169,119,43,126,162 
LET b-53700: LET (=360: LET 7855 DATA 196,33,211,126,170 
e: RESTORE 7810 7856 DATA 119,43,126,163,196 
FOR i=@ TO t-1: READ а 2857 DATA 33,211,126,171,119 
POKE (b+i),8: LET z=z+a 7858 DATA 8;61,40,25,8 
NEXT i 7859 DATA 221,55,56,124,230 
LET z=INT (((z71)-INT (2/40 
| 28609 DATA 7,32,183,1,49 
вас READ at, тр арт ТӨЛЕМ Бран 2861 DATA 0;8,95,8,62 
; 2255 БЕТА 14:152:22245:495 
| 7863 о! а 294, А 7. 
рата 229,213,197,245,229 $864 DATA 209,225.58,41,211 
DATA 221,225,120,205,177 7865 DATA 201,237,67,21,211 
DATA 34,49,32,237,67 7855 DATA 62,21,8,221,94 
DATA 15,216,50,229,209 7867 DATA 0,221,856,21,221 
DATA 62,21,6,221,94 3368 бата 78,42,35,35,126 
DATA 2,221,86,г21,221 7869 DATA 161,196,33,211,126 
рата 78,42,5,1,175 
DATA 203,27,203,26,203 7870 DATA 169,119,43,126, 162 
DATA 25,31,16,242,35-- 7871 DATA 195,33,211,126,170 
DATA 35,95,174,119,43 2878 DATA 119,43,126,163,196 
7873 DATA 33,211,126,171, 119 
DATA 126,169,119,43,126 7874 DATA 8,61,48,201,8 
DATA 170,119,45,126,171 2875 DATA 221,355,95 ,124,230 
PATA 119.9,61,40,25 | 7876 DATA 7,928,206,6,95 
DATA 8,221,35,36,124 2877 DATA 85,1,208,46,62 
DATA 2390,.7,02,2905,1 2875 DATA 21,147,128,71,205 
DATA 49,0,5,95,98 7879 DATA 177,34,24 , 190,245 
DHTH 62.21,14:..190.71 таза DATA $2,1,50,41,211 
Bara 523.153; 36525257281 2881 DATA 241.201,1,0,0 
DATA 237,67,81,248,62 | вва: опънчазив алада 


The sprite-handling routine 

This routine, FNg, allows you to control the movement of 
sprites. The routine works in conjunction with the master 
sprite routine, and both must be present in memory for 
sprites to move on the screen. The routine has a range of 
parameters to control exactly how the sprite will appear 
on the screen. 


How to use the routines 

Having produced some sprites, it is a simple matter to 
display them against a background, and the ideal way of 
creating backgrounds is to use a graphics editor program 
such as that in Book Three. All the background displays 
in this book were created using the graphics editor. The 
programs in this book do not themselves create back- 
grounds; you must add these yourself. 


Interrupts 
Most machine-code routines are called (as you will have 
seen) from BASIC, and are then executed іп much the | 
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TYPICAL SPRITE BACKGROUND 


same way as the BASIC program, line by line. When the 
machine-code routine has finished running control is 
returned to the BASIC program. However, there is a 
much more sophisticated method of using machine code, 
which is to make a routine run independently of BASIC. 

This can be achieved by taking advantage of the fact 
that at regular intervals the Spectrum interrupts the 
running of any BASIC program or machine-code 





routine which is being executed. It does this so thatit can 
print information on the screen, and perform various 
other household chores, like memory management. 
These interrupts occur at least fifty times a second, so 
in fact that if you carry out a machine-code 


quickly 





Sprites move in blocks of three pixels. On reaching an obstacle, and 
with the collision flag set to 1,a sprite continues to move for three 
pixels before stopping. 





FNg 

















three-pixel 
moyement 








routine as well as a BASIC program using interrupts it 
will appear that both things are happening simultan- 
cously. 

Two of these "interrupt-driven" routines have been 
provided in this book. One is the keyboard-controlled 
sprite, and the other is the interrupt-driven window 
given on pages 32-33. 








Start address 53500 Length 170 bytes 
Other routines called Master sprite routine. 
What it does Prints and moves a single sprite on the screen. 


Using the routine The screen area is measured in pixel co- 
ordinates from the top left-hand corner, rather than from the 
bottom of the screen. 

Sprites move in multiples of three pixels, so a value of 60 for | 
moves the sprite 180 pixels. If the collision detection flag is set 
100, the sprite will pass over obstacles (any pixels with INK set). 
If cis set to 1, the sprite will stop when it hits an object (after an 
overlap of three pixels). You can find out the precise position 
where a sprite stopped by PEEKing locations 53498 and 53499 
for the y and x co-ordinates respectively. 














specify top left-hand corner of sprite (х<<232, у< 155) 








direction of travel of the sprite (O=left, 1 一 right, 2—up, 
3=down) 








| distance moved (vertical < —51, horizontal<=77) | 








switch (s=1 to disappear, s=0 to remain on screen) 




















5 
с collision detection flag (i=stop, 0 一 continue) 
n specifies number of sprite (1-10) 
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The sprite-handling routine has many user-controlled 
features built into it, as you can see from the long list of 
parameters which are passed to it. It is a good idea to 
become familiar with these, as otherwise you will under- 
utilize the potential of this very powerful routine. The 
train program, given here, is a good example of how the 
parameters are used. 


The train program 

The large display on this page shows a train and some 
carriages being shunted along a railway line. All the 
movement in this program is controlled by the sprite- 
handling routine. Lines 110 and 120 take the train 
sprite and move it from left to right across the screen. A 


mirror image of the train is then selected and driven 
back to the start position, where it remains on the 
screen. Lines 130-150 set up a loop which calls carriages 
one by one. Since this contains the collision flag set to 1 
each carriage moves across the screen until it 
encounters an obstacle—the previous carriage — when 
it stops and remain on the screen. 


More about the parameters 
It is worth looking at the impressive range of parameters 
available with the sprite-handling routine in a little more 
detail. 

The first feature which you will use, of course, is the 
specification of the x,y co-ordinate at which you want 















































TRAIN PROGRAM 





18 DEF FN 9(x,¥-d,l,5,0,n) USR 
ѕзБее 
128 BORDER 4 

118 RANDOMIZE FN әсгев,139,2,68 
“388 RANDOMIZE FM 3(1,199,1,70,1 


138 FOR x-1 TO 7 
140, RANDOMIZE FN 9 (1,139,1,70,1 


NEXT x 
160 PAUSE ә 
170 GO TO 119 


the sprite to start. Normally you can specify this simply 
by looking at the screen, but more sophisticated 
methods are available for determining the start point. 

In the program example a train appears from the left 
and crossesto the right-hand side. It travels a distance of 
65 (that is, 195 pixels) and so you know that you can 
start the second train off from a point 195 pixels to the 
right of where the first started. But what if you didn't 
know where the first train had started or stopped? Since 
the routine stores the last pixel position of the sprite at 
two pointers in memory, the new sprite could then start 
from position (PEEK(53499),(PEEK(53498)). 

"There is a case for making the distance moved by the 
sprite (parameter 1) as short as possible with each call to 
the routine, despite this producing some flicker because 
ofthe volume of transfers from BASIC to machine code 
and back. This is because while you are in BASIC you 
can keep a check on the current screen, the position of 
the sprite and so on, but while the sprite is moving you 
do not have any control over it. This, of course, is an 
advantage of interrupt-driven routines which allow you 
to monitor the progress of other things on the screen 
while a sprite or window is moving. 

The value you give the switch, s, depends on what you 
want the sprite to do after you have finished using it. In 
the program the switch is off for the first train and on for 
the second: after the first train has come on and travelled 
across the screen it should disappear before the second 
returns. On the other hand the second train must remain 
on the screen after its journey as, if it doesn't, the 
carriage will have nothing to run into. 








The bat program 

The final program on this page shows how the sprite- 
handling routine can be called a number of times in a 
loop to move an object in four different directions 
around the screen. Although you see the bat moving 
continuously on the screen, the program listing reveals 








that four different routine calls are being used, one for 
each direction that the sprite is being moved, and three 
different sprite shapes are used to give various views of 
the bat’s body as it moves around the loop. 


BAT PROGRAM 





10 DEF FN 9(x,u,d,i,s,c,n) -USR 
әз 


5 
за BORDER 1 
10 RANDOMIZE FN 9(45,140,1,40, 


ó FN 9(182,140,9,94 
FN 9(177,25,0,40, 
FN асав,25,2,42,0 

“ава co ro ге 


























NAC T DUF 











The keyboard-controlled sprite routine, FNh, enables 
you to control the movement of sprites using the cursor 
keys. The only difficulty with the routine lies not so 
much in using it as in switching it off. Because the 
routine is interrupt-driven it continues to operate after 
any BASIC program has finished. Even as you edit a 
program you will find that the sprite is still moving on 
the screen. A subroutine is required to switch it off: 


2000 DEF FN z(s)-USR 53100 
2010 RANDOMIZE EN z(0) 
2020 RETURN 


This redefines the routine with just one parameter, the 
switch. If the switch is given a value of 0, the routine will 
be switched off. The maze program on page 20 gives you 
a chance to try using the routine; you can create your own 
maze with the Book Three graphics editor. 








Controlling the routine 

Although keyboard-controlled, the routine is quite hard 
to control from within a program. Since the sprite 
routine runs outside BASIC, it is only when the routine 
stops that you can check its position. One solution is to 
leave the collision detection off but to set up your own 
collision detection instead. You can do this by switching 





the sprite off, and looking at the last x,y 
(stored at 53099, 53098), Then use the POINT 
command to find if pixels at these co-ordinates are set: 
Xy х+24,у 

х,у+21 х+24,у+21 


If this is so, a collision has occurred. 














MAZE PROGRAM 


DEF FN hís,x,u,C,n) -USR 531 


DEF ЕМ z{(s)=sUSR 59100 
BORDER 


2 
RANDOMIZE FM h(1,1,50,0,3) 
зо то 126 

STOP 

RANDOMIZE FN z(@) 




















Start address 53100 Length 250 bytes 

Other routines called Master sprite routine. 

What it does Puts a sprite on the screen and allows it to be 
controlled by the cursor keys. 


Using the routine The routine is interrupt-driven, so it will 
continue to respond to keyboard presses until switched off by 
calling the routine with the switch parameter (s) set to 0. 

If not switched off, the routine continues to operate even when 
you stop the program and attempt to, say, edit — you will see а 
Sprite moving whenever you use the cursor keys. It is advisable 
to switch the routine off at the end of any BASIC program which 
calls the keyboard-controlled sprite routine. This can be done by 
defining the function a second time using a function title not 
used elsewhere in the program, say FNz. This function 15 defined 
as having a single parameter only, s, which means that the 
function can then be called with this parameter only, set to zero. 
The collision detection parameter, c, can be used to detect if 
the sprite passes over any pixels with set INK attributes. 









switch (L=on, 0—off) 
Xy start position of sprite (0<=x<—231, 0 —y« 154) 
с collision detection (1—0n, 0—off) 


n number of sprite (1-10) 1 
























































The obstacle program 

The final program again has the aim of avoiding 
obstacles. Lines 10 and 20 define the routine twice as 
before. Line 110 switches the keyboard sprite on. Lines 
120-140 print a series of random graphics blocks on the 
screen, The aim of the game is to avoid these blocks. Line 
500 is a continuous loop which keeps the program 
RUNning. 
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You have already seen what can be done with a sprite 24 
by 21 pixels (504 pixels in all), but there are occasions 
when you would like to use larger sprites still. This makes 
great demands upon your Spectrum, but the two routines 
that are provided here (FNi and FNj) each give you the 
power to niove over 1000 pixels at once. These routines 
provide you with double horizontal and vertical sprites 
respectively. In each case sprites from the sprite table are 
attached to one another and are then moved together in 
exactly the same way asa single sprite — though naturally 
not quite as quickly. 





The double sprite programs 

Both the demonstration programs are straightforward. 
In the first program, a double horizontal sprite has been 
used, and this demonstrates the effectiveness of quite 
large moving objects — it would take 18 user-defined 
graphics to define the area of the car, let alone move it! 
‘The program enables you to see the great improvement in 
sprite visibility that can be obtained by doubling its size. 


Start address 52400 Length 235 bytes, 

Other routines called Sprite editor routines (FNa-FNe). 
What it does Displays and moves two sprites together hori- 
zontally on the screen. 





Using the routine The routine takes sprites n (left) and n 十 1 
(right) from the sprite buffer. Parameters are as for the sprite- 
handling routine (FNg). Bytes 52398 and 52399 specify the y 
and x co-ordinates of the sprite's final position after calling the 
routine, 









DEF ЕМі(х,у,9,1,5,с,п) 
xy | tart co-ordinates (0<=x<=231,0<=y<=154) 




















specifies direction of travel (0—left, 1 
3 一 down) 


right, 2—up, 











І [sistance moved (vert<=51, horiz<=77) 
5 [switch (1--оп, 0—off) 
с |Пав for collision detection (1—on, 0—off) 


























n [number of first sprite (1-10) 











Ба-ЕТ ‘=239: LET 






С-1: READ a 
fb+id,a: LET z=z+a 


7554 LET z-INT (((z7/1)-INT (2/19 


7555 READ а: IF a«»z THEN PRINT 
= : STOP 











first and second of the sprite table — the routine simply 
takes the sprite specified by the n parameter, together 
with the following sprite from the sprite table that is 
stored in memory. 
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AUTOMOBILE DISPLAY FNj 








Start address 52100 Length 230 bytes 
What it does Displays a double vertical sprite. 


Using the routine Used in the same way as the horizontal 
sprite routine, but final sprite position now specified by 52098 
and 52099. 


ROUTINE 








DEF FNj(x,y,d,1,5,¢,n) 
ху [ start co-ordinates (0<-х<-2310<-у<-154) 














d specifies direction of travel (0—left, 1—right, 2—up, 
3=down) 








distance moved (vertical « —51, horizontal « —77) 


switch (1--оп, 0—off) 
The other program shows a double vertical sprite — a с flag for collision detection (1—on, 0—off) | 

unicyclist — against a circus background, drawn using 
the graphics editor from Book Three. Гт 1 
UNICYCLE PROGRAM 



































[ number of first sprite(1-10) 
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ANIMATION 1 





So far the movement you have seen has been restricted 
to moving fixed sprites on the screen. Thisis all very well 
if your sprite is an aeroplane flying across the sky, or a 
car driving along, because these do not change shape as 
they move. However, if you want to have a moving 
person or a flying bird then something more sophisti- 
cated is required: the sprites need to be animated while 
they are moving on the screen. 

Animation, like most techniques in computer 
graphics, relies on tricking the сус. It is achieved by 
displaying several stationary images in succession to 





create the illusion of movement. Animation can be 
achieved without any relative movement, as in an 
animated figure of a man jumping on the spot, for 





The body of the horse sprite stays in the same position in suc cessive 
frames (shown in red and blue); only the legs and tails of the horse are 
moved, 

















































































































example. You will immediately notice when you start to 
animate your designs how only a small change in the 
sprite shape is required to give an effective result. By 
looking at the display in the figure above. for example, 
you will see how only the legs and tail of a horse need to 
be moved to give an animated effect; the horse’s body 
remains unchanged. If the body was moved when the 








ANIMATION PROGRAM 


кк, udo uS ey 
PAPER S: INK © 
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ғы к(вов,12,9,65, 


horse was animated, the effect would look very jerky. 

In many cases you only need to take two frames and 
switch between them to produce convincing animation, 
but the animation routine, FNk, allows you to have as 
many frames as you like, within the limits of the sprite 
table — that is, up to a maximum of ten. Using ten 
frames, each of which differs slightly, you can create 
very effective illusions: unless you think about what is 
happening you would never realize that the sprites are 
being printed as stationary images. 

The illusion produced by animation is also used in the 
cinema, where stationary images are shown one after 
the other at 14 frames per second. When watching a film 
you don’t think of the picture as stationary, because the 
images are changing too fast for your eye to register. 
Since the animation routine allows you to vary the speed 
at which images are replaced on the screen, you can 
experiment by giving different values to the v parameter 
to see how slow the animation can be before your eye 
begins to detect the frames making up the movement. 


























HH 





































































































Start address 51700 Length 275 bytes 
Other routines called Master sprite routine. 

What it does Uses a sequence of sprites from the sprite butter 
to give the effect of animation. 


Using the routine Most of the routine parameters are as 
before, with some additional ones added to give you increased 
control of the animated sprites. Thus, the frame parameter 
specifies how many frames are used in the animation, and the 
velocity parameter determines how quickly the routine should 
lius "om one frame to the next. Do not give this parameter a 
value of 0. 


[ 









DEF FNk(x,y,d,l,s;f,c,v,n) 
sprite start co-ordinate (0<х< 256, 0<y<176) 














d specifies direction of travel (O=left, 1 一 right, 2=ир, 
3 3 一 down 








1 distance moved (vertical<—51, horizontal <—77) 
5 71 switch (1 一 switch on, 0 一 switch off) 
f | number of frames used in the animation (1-10) |] 
- MIS ORT 
П 




















Нар for collision detection (1-оп, 0-00) _ x 
velocity of animation (1<-у<-255, the slowest) wal 




















n number of first sprite (1-10) 











The animation program 

This program has not been displayed for the obvious 
reason that it is difficult to capture the effect of move- 
ment in a still photograph. The program takes five 
sprites and displays them in turn to give a very smooth 
effect of movement. The five sprites are shown along 
the bottom of the page as they appear on the sprite 
editor. Notice how similar each horse is to the next; only 
minor changes are needed for the animation. For an 
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even better result, increase the number of frames. 
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ANIMATION 2 


How does the animation routine work? The answer is 
simple for you, but not quite so simple for the 
programmer. What happens with ordinary sprites is that 
they are picked out of memory, printed on the screen and 
moved across it, according to the parameters passed to 
the routine, With animation the first sprite is picked out of 
memory, displayed on the screen, and moved one position 
(three pixels in the case of the sprites in this book). The 
sprite is then deleted from the screen, and the next sprite 
in the sequence (the equivalent of the next frame in a film, 
or next drawing in an animated cartoon) receives exactly 
the same treatment. It is printed on the screen, moved 
three pixels and then wiped off again. 

The sequence continues until all the frames in the 
sequence have been displayed, and then starts again. 
Some applications are ideally suited to two frames (like 
birds flying), but obviously the more frames in the 
sequence, the smoother the animation will be. For this 
reason itis best to choose to animate things which havea 
regular and repetitive movement. 


Transferring animation to the screen 
Sooner or later you will want to start designing your own 
animated characters, The technique recommended is to 
begin by reproducing the movement you see, as simply 
as possible. Remember that your eye will help by per- 
suading you that things resemble real life, even though 
they are not. Secondly, remember that the effect you are 
aiming for is a flowing movement. To achieve this it is 
necessary to make sure that the last frame in the 
sequence runs into the first, so that the sequence is 
circular — after all this is the way it will be projected 
onto the screen, One of the commonest errors made in 
animation is to have an open-ended sequence, so that 
when it is shown repeatedly on the screen the effect is 
smooth during the sequence, but with a jerk at the end as 
the sequence restarts. 

You are fortunate enough to have the sprite editor and 
the sprite print routine to help you with your designs. You 
will find that designing on the screen is much easier than 
sitting down and working out an image with a pencil anda 
grid. As a further aid, several animated sequences have 
been provided in the sprite design directory later in the 
book. Using the sprite editor, you can start a new sprite 
design from a previous one and so create smooth and 
flowing animation sequences with little difficulty. 


Trying out the animation 
When you have designed an animation sequence you can 
use the sprite print routine to preview your designs. You 
saw this idea used with a robot earlier in the book, but the 
point of using the print routine here is twofold. 

The first point is that it is much easier to be analytical 





and critical about a sprite design if it is not moving across 
the screen. If you print your sequence one after the other 
onto the same screen position in a continuous loop you 
will get some idea about where changes need to be made 
(if any) before the sequence is animated properly. 

Secondly, you will be able to judge more accurately the 
sort of speed at which the sequence should be animated. 
Puta PAUSE statement between each print statement in 
the loop, starting with values of about 20. You will then be 
able to see how much the animation routine needs to be 
slowed down to be most effective. In practice you should 
multiply the results you get from tests with the PAUSE 
statements by a factor of between five and ten (that is, 
PAUSE 20 converts to a value for v of 100), simply to 
compensate for the fact that machine code is so much 
faster than BASIC. 

It is a good idea to make use of the sprite print routine 
for one more reason. Once a sprite is being animated with 





WILDLIFE DISPLAY: BIRD 
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the animation routine it is impossible to stop it until the 
distance | has been covered. This can take quite a while if 
you have long pauses between each frame of the 
sequence, However, with the sprite print routine you can 
break into the program between single frames at any 
point since the Spectrum is returning to BASIC between 
each call to the print routine. 
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Once you are completely satisfied with the edited 
results and the way that they work with the sprite print 
routine then you should be sure to save the sprites 
generated to tape, as a separate file. The reason for this is 
that after all the effort you have spent getting the sprite 
right it would be a pity to lose them through a clerical 
error — ora momentary power cut. 


The wildlife program 

The displays on this page are both produced by a single 
program. Both displays use two states of animation, and 
both move the animated sprite across the screen and 
back again. The movement of the hare (shown in the 
large display below) is simplified to two states — the 
elongated position, and the familiar crouching pose. 
Alternating between these two provides a reasonable 
approximation of movement. The two bird sprite states, 
shown in detail in the close-up photograph, show how 
both the wings and body of the bird are made to move. 
You may find the bird’s movement rather jerky. One 
way of overcoming this, without increasing the number 
of frames, would be to reduce the displacement of the 
body by keeping it more central, rather than rising and 
falling within the 24 by 21 frame with each animation 
state. 


ad 
cieli Rei nA P 
НН НИИ РН 
ИННА НИ 


UAI RH RANA ANH 


RN NA 





маши 












































SCREEN SCROLLING 








All the movement you have seen so far relies on the idea 
of you being stationary and something moving past you. 
But how can you create the illusion of moving past 
something which is stationary? The most effective way 
of doing this is by scrolling the whole screen, There are 
several ways of doing this; the simplest can be seen 
whenever you use the BASIC command LIST, which 
scrolls the screen upwards one character at a time 


The scroll routines 
To create a more effective and gentle illusion of move- 
ment you need a smoother scroll, which moves the 
screen one pixel at a time. The two routines given here, 
FNI and FNm, allow you to scroll the screen a pixel at а 
time in either a horizontal or a vertical direction. 
Note that when using the two scrolling routines on 
this page, it is inadvisable to use an interrupt-driven 
routine (such as the keyboard-controlled sprite routine, 
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[ SCREEN SCROLLING PROGRAM | 
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RANDOMIZE É 














SCROLLING THE SCREEN VERTICALLY 














FNh) at the same time. This is because the scrolling 
routines are shifting the co-ordinates of screen memory 
back and forth as the screen is scrolled, and an image is 
displayed on the screen by interrupts being used to 
“refresh” the screen atregular intervals. Obviously, this 
can cause problems if the screen display moves its 
location in memory when the screen refresh routine 
looks for it. 

A similar difficulty arises when using PAUSE, since 
this statement is also based on interrupts. Rather than 
use PAUSE between two calls to a scroll routine, you are 
advised to usea FOR...NEXT loop for a delaying effect. 








Other scrolling effects 

Several effects can be linked to scrolling the screen. 
Both of the scroll routines have a wraparound effect, 
which means that whatever goes off one edge of the 











| Start address 51500 Length 190 bytes 
What it does Scrolls the screen left or right a specified 
Istance. 





Using the routine Parameters d and | set the direction and 
length of scroll. The routine has a wraparound effect, so that 
whatever disappears off the left of the screen reappears on the 
right, and vice versa. 





DEF FNI (0) 








1 specifies length of scroll (0-255) 

















d specifies direction of scroll (0—left, 1—right) 
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| Screen then reappears on Ше opposite edge. Other 
| routines allow you to leave something stationary on the 
screen while scrolling the rest — as used in popular 
games like Defender and Pole Position. To do this 
requires a much longer routine than those given here. 
However, another type of scrolling effect has been 
included in this book. This is a partial screen scroll, in 
which the vertical dimension of the area scrolled is 








Start address 50900 Length 215 bytes 
What it does Scrolls the screen a specified distance up or 
down. 





Using the routine Parameters are the same as for the hori- 
zontal scroll routine. As before, a wraparound effect occurs 
with the routine, but in this case when scrolling off the top and 
bottom of the screen. 








DEF FNmi(l.d) 








т | specifies length of scroll (0-175) 
а | specifies direction of scroll (0==ир, 1 一 down) | 


erET ‹=229: LET 


1-1 READ a 
LET z=z+a 
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7204 LET z-INT 
7205 READ а: IF a< 
"27": STOP 


(CO 4^0) - INT (2/19 
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restricted to the size of the sprites used in this book. This 
partial screen scroll routine (given on page 30) produces 
what is in effect a window. 

The program on this page shows scrolling at work, 
You will notice that the routine has the effect of moving 
ink attributes while leaving coloured areas unchanged. 
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As you saw on pages 28-29, it is often more useful to be 
able to scroll parts of the screen than to scroll all of it. 
The window routine given here, FNn, enables you to do 
this. With the routine, you can define an area of the 
screen three characters deep of any width. and then 
move a sprite across it. The routine enables you to make 
sprites appear to move behind objects on the screen, 
since they appear from outside the window and then dis- 
appear the other side — rather like looking out of a 
window and watching a train go past. 


Repeating sprites 

One additional feature of the window routine is that you 
can repeat the sprite to give the effect of a chain of 
sprites passing through the window. Alternatively, quite 
spectacular effects can be achieved by having a variety 
of sprites set up in the sprite table, like the sequence 
produced by the cockpit program shown on this page. 


Differences between sprites and windows 

In many cases, you may find it more useful in your 

programs to use this window routine than a standard 

sprite routine. However, when using the routine, it is 

important to remember that the routine is essential 
87 





scrolling, rather than a sprite routine, and that every- 
thing contained in the window will be scrolled by the 
routine, even if it was only part of the original back- 
ground, To display a sprite moving against a static 
background, or to move a sprite vertically, you must use 
one of the sprite routines. 


COCKPIT PROGRAM 


















ag DEF FN пх«х,у,%,п,4,с) лова 4 
98 FOR х=1 TO 1 







в Ze Fi 
NDOMIZE FN 
ЗЕ зе 


138 мехт х 
140 СО To 100 


































Start address 49600 Length 290 bytes 
What it does Moves one or several sprites across a window of 
specified dimension. 


Using the routine The routine carries out a partial screen 
scroll: everything contained within the area defined by the 

arameters is scrolled. 

ote that the start co-ordinates x,y represent the top left hand 
corner of the sprite if the sprite moves right, but the top right- 
hand corner of the sprite if the sprite moves left. The repeat 
flag, r, can be used to repeat a sequence of sprites moving 
across the window. Repeated sprites can be seen in the window 
game program on pages 32-33. 











start co-ordinates (0<=х<=31, 0<=у<=21) 
width of the window (0<-1<-31) 
- || number of sprite to be scrolled (n—1-10) 


specifies direction of scroll (O=right, 1 一 left) 


repeat flag (1—switch off repeat, 0 一 repeat) 









































The cockpit program 

The large display on this page shows windows at work 
From the interior of an aircraft cockpit, various air- and 
spacecraft can be seen flying across in front of the plane; 
the display shows one of these. What is particularly 
effective is the way the sprites disappear behind the 
centre pillar and reappear in the other window — an 
effect which could not be achieved with the sprite 
routines. This program, then, shows the real difference 
between windows and sprites — using windows you can 
make the sprites look as if they are behind a solid object 
rather than in front of it. 





How the program works 
Line 10 of the program defines the window routine, 
together with its assortment of parameters. As you can 
see, three characters wide is a very effective width for 
the routine. The program actually uses two windows, 
three characters apart, with a barrier (the window 
frame) in the middle of the screen. The eye. however, is 
tricked into believing that the sprites are moving along 
behind the windows when they are in fact disappearing, 
stopping, and then reappearing as a result of a second 
window call. Line 100 sets up a loop so that all ten sprites 
can be made to appear across the window, one by one. 
Line 120 deals with the sprites that are left facing — 
that is, all ofthe sprites which appear to fly from right to 
left. This works by testing for the second, fifth and 
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seventh sprites which are right facing. If any other sprite 
is to be used then it is first made to go across the right- 
hand window, immediately followed by a call to make it 
go across the left-hand window. A PAUSE statement 
has been added to give you time to think about what just 
flew in front of your eyes! 

Line 130 behaves in the same way, but handles the 
right facing sprites. Sprites 2, 5, and 7 and upwards 
appear to face to the right, so these are made to fly across 
the left-hand window first, immediately followed by a 
second call to make them fly across the right-hand one. 
Line 140 ends the loop, and finally line 150 starts the 
whole process over again. 
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The window routine given on this page has all the features 


of the window routine, FNn, but with the added feature of 


being interrupt-driven. Once switched on, it will keep 
going until switched off again, regardless of just about 
any BASIC command. 

Your first priority with this routine must be to have a 
way of switching it off. As for keyboard-controlled 
sprites, this is done by a subroutine: 


2000 DEF ЕМ z(s)-USR 53100 
2010 DEF FN x(s)-USR 49200 
2020 RANDOMIZE EN z(1) 
2030 RANDOMIZE EN 2/0) 
2040 RANDOMIZE EN х(0) 
2050 RETURN 


‘This subroutine is slightly more complicated than you 
would expect, since itis used both to set up theroutine and 
to switch it off again. The routine also switches on the 


WINDOW GAME PROGRAM 
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RANDOMIZE FN h(1,32,159,0,1 
IF IMKEY$-" " THEN GO TO 23 
Go то 210 
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ET ng=: 
42_AND 2 хвстава THEN 
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WINDOW GAME PROGRAM CONTD. 
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keyboard-controlled sprite routine, since this sets up the 
interrupt vector table required for the interrupt-driven 
window routine to work correctly, 

The interrupt-driven routine can be used together 
with the other routines in this book to set up and run 
sophisticated games. A simple game is given here; you 
will be able to improve it with a little effort. 





The window game 

This game is based on the idea of shooting at moving 
objects at the top of the screen. The game uses three 
machine-code routines, An interrupt-driven window is 
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UFOs controlled 
by window routine 














arrows controlled 
by sprite-handling 
rouune 


№ PE MM 


| keyboard-controlled sprite routine 











used to make flying saucers scroll across the top of the 
screen, the keyboard-controlled sprite routine is used to 
control your scanner, and the sprite-handling routine is 
used to send arrows towards the saucers. 

One of the best parts about writing a computer game 
is in deciding the scenario for the game. In this case you 
could imagine, for example, you are trapped on earth 
with only a scanner satellite, and your crew aboard it 











Start address 49200 Length 315 bytes 
nee routines called Keyboard-controlled sprite routine 


What it does Moves either one or several sprites across a 
итен» and continues to operate whatever is happening in 
BASIC. 


Using the routine To use this routine you must first switch on 
the keyboard routine, since this routine sets up tables of 
interrupts where needed. The keyboard sprite routine can then 
be switched off again, unless it is called in the program else- 
where. Use s in the same way as it is used in the keyboard 


controlled sprite routine. 

Note that the start co-ordinates xy of the window routine 
represent the top left-hand corner of the sprite if the sprite 
moves right and the top right-hand corner if it moves left. 











DEFFNosxylmdr] — | 
$ stop Нав (1—stop, 0—normal) ] 








[start co-ordinates (0€ —x«—31, 0<-у<-21) 1 
1 Дейн of window (0<-І<-3) | 














number of sprite to be scrolled (n—1-10) 








n 
d specifies direction of scroll (0—right, 1 一 left) 














repeat flag (1 一 Switch off repeat, 0 一 repeat) 
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haveonly a bow and arrow with which to repel invaders. 
You can also use other sprites with the same background 
to change the feel of the game. Using different sprites, 
you could convert this game to a fairground shooting 
gallery, for example. 

Several refinements could be made to the program. 
One sensible one would be to stop the keyboard sprite 
from going too high up the screen. This could be done by 
testing the current y co-ordinate of the sprite (stored at 
location 53098), and starting the sprite again at the 
bottom of the screen if a given limit is exceeded. 





How the program works 

Lines 10-20 define the three machine-code routines. 
Two of these routines are interrupt-driven and will 
therefore have to be switched off at some point. Lines 40 
and 50 are here for this reason. These extra function 
definitions enable you to switch the interrupt-driven 
routines off and on by calling the routine with just one 
parameter, without bothering about specifying all the 
other parameters normally required. 

Line 110 sets up some variables. The current score is 
held as variable sc, and the previous score (before the 
current arrow was fired) as psc. Variables g and ng are 
used to record the position of the keyboard sprite under 
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the gaps, with ng defining the gap under which the sprite 
is resting, and g the previous gap. These variables can 
have values between 1 and 4 (since there are four gaps 


through which you can fire), and these variables are 
used to restrict your firing. The program compares 
variables g and ng in line 310, and if they are the same, 
the fire sequence is bypassed. At the beginning of the 
game, itis importantthat g and ng have different values, 
so that the fire sequenceis not disallowed initially. Thus, 
gis set at first to -1, a value which ng can never have. 


























Lines 120 to 170 of the program draw the background, 
with a loop used to create the sides and top, and line 170 
creating the gaps through which you can fire. Line 180 
calls the score subroutine at line 500. 

Line 190 starts off the interrupt-driven window, 
though it does not begin working until the interrupt 
vector table has been set up by the keyboard-controlled 
sprite routine. Because this is the very next statement you 
do not see any delay, but it is important to remember that 
the interrupt-driven window will not function unless this 
table is in place. The window routine will continue to 
scroll a sprite across the window until something occurs to 
stop it. 

Lines 210-220 form the main program loop, which 
simply waits for the space key (the signal to fire) to be 
pressed, since everything else at this stage is interrupt- 
controlled. The controlling keys for the keyboard sprite 
must of course be ignored, as their function is handled by 
the machine-code routine. 

Lines 230 and 240 find out the current position of the 
keyboard-controlled sprite. Given the position of the 
sprite, and the gaps in the barrier, the program can 
decide whether a shot fired would go through a gap. 

Lines 250-280 work in the same way for each of the 








four gaps. First a test is made to see whether the keyboard 
sprite is under the current gap. If it is then the gap flag 
(ng) is set to the value of the current gap. In addition the 
current score is incremented by two — not one as you 
might expect. Line 290 normalizes the score by taking 
one away again. Note that if the keyboard sprite is not 
under one of the gaps then the score is now one less than it 
was before the shot was fired. 

Line 300 looks at the past score compared with the 
present score plus 1, and makes the gap variables 
different from their previous values, if the sprite was not 
under a gap. Line 310 deducts another one from the score 
if the gap is the same as the last gap which was fired at. It 
also skips the arrow-firing sequence, since arrows are only 
fired if the gap is a new one. 

Line 280 fires an arrow by calling the sprite routine. 
Line 340 makes sure that the score cannot become 
negative, however bad the player. Line 350 adjusts the 
values of the previous score and the old gap value, ready 
for the next time round the loop, Line 360 prints the new 
score, 

Finally, lines 1000-1020 switch off the interrupt- 
driven routines. To break out of the program, key GO 
TO 1000 to stop the routines. 
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USING THE SPRITE DIRECTORY 





While using this book, you will have found that 
producing good sprite designs is not always easy. To 
overcome this problem, you can turn to the sprite 
directory, which contains over 200 sprite designs. These 
sprites can either be copied directly in your own 
programs, or used as a model on which to base your own 
ideas. Each entry in the directory includes the DATA 
for the sprite and shows the sprite on the screen. 


Keying in the sprites 
A sprite from the directory can be keyed in by using the 
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,170,326,118,0 
34,100,0,67,68,40,67 
196,16,64,194,130,128,2 
108,128,1,17,0,0,130 
0,0,68,0,0,56,0 
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following loading program (add DATA from line 100): 
10 INPUT “Sprite number (1-10)”,a 

20 IF ад OR 210 THEN GO TO 10 

30 LET b=54600+((a-1)+63) 

40 FOR i=b TO b+20 

50 READ n: POKE in 

60 READ n: POKE i+21,n 

70 READ п: POKE i+42,n 

80 NEXT i 

100 DATA 0,0,0,0,егс 

The routine loads the sprite in the DATA statements 
into the sprite location specified by you at the start of 
this BASIC program. The routine requires you to key in 
all 63 sprite DATA items, even if some of them are 
zero.The sprite table can easily be corrupted by wrong 
DATA being entered, but the easiest way to correct this 
is by editing the sprite image with the sprite editor. 








What the directory contains 

The directory groups various kinds of sprite under 
theme headings. Most of the sprites are designed to be 
used individually, but the directory also contains some 
double sprites, which are used in conjunction with each 
other. In addition, a number of animation sequences of 
sprites in two or three different positions are included. 
The sprites can be entered either by keying inthe DATA 
numbers provided, or simply by copying the drawing 
using the sprite editor, The sprite editor can also be used 
to increase the number of frames in an animation 
sequence, up to a maximum of ten designs (the 
maximum number of sprites that can be held in the 
buffer at one time). 























PACIFIC-TYPE LOCO 


HOW SPRITES ARE SHOWN 








The diagrams shown illustrate how 
sprites are displayed in the 
directory. Each sprite is shown in 
the top left-hand corner as it 
appears on the screen, and in the 
large display below as it can be 
keyed іп ona grid. The63 DATA 
numbers which are POKEd into 
memory are shown on the top right 
ofeach sprite display. 

Note that double sprites are 
shown as two separate sprites; 








obviously, the sprites will appear 
joined when used with the double 
horizontal sprite routine (FNi). 
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PHANTOMS | 














































































































































































































































































































































































































































































































































0,0,0,0,0 
0,0,0,0,0 
12,64,0,3 
64,92,30, 
127,254,127,255,252, 
240,65,8,0,65,8,0 
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8,255,136,8,156, 136,29 
136,220,21,136,212, 28,28 
28,0,28,0,0,20,0 


0,0,0,255,255,254,0 
16,0,0,16,0,0,16 
2,0,56,0,4,56,64 
7:199,192,4,124,64,0 
254,0,1,11,0,1,17 
0,3,17,128,5,1 
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126,0,0,126,0,0,24 
0,0,60,0,0,126,0 





1255,193,119,255 
254,14,0,62 
122,248,0 


0,128,0,0,192,0 
196,0;3,244,0,0 
2,0,212,0,0,148,0 
0,21,0,30,149,120,34 
151,68,67,255,194,131,24 
93,131,36,193,125,231,190 
57,255,156 ,3,255,192,4 
219,32; 11, 9,208,28,0 
56,32,0,4,248,0,31 























































































































4,68, 32,10, 34,32,25 
132,36, 137,64, 18,70 
238, 9,33, 240, 4,205,228 
2,223,208,1,63,4 
122,147,0,255,136;1 



















































































0,0,2,0,0,4,0 
0,12,0,0,24,0,0 
16,258,248,12,146,72,64 
24,144,128,42,161,0,11 
194,0,15,132,0, 
0,7,243,160, 
28,191,234,57, 
181,234,13,181 





























"RAILWAY TRAINS 











CARRIAGE 











U.S. LOCO 











0,60,0,0,24,0,31 
255,248,33,0,132,127,255 
254,36,36,356,36, 36, 
36,35, 36, 36, 36,38, 36 
36,38,36,36,36,63,255 
252,55,247,284,60,50,50 
63,255,252, 191,255,253,255 
255,255, 191,255,253,19,36 
200,19,36,200,12,195,48 



































224,127,1,240,63,9,240 
3,28,224,3,92,224,9 
255,254,122,255,254,255,255 
255,255,255,255,255,255,254 
231,159, 254,216,96,0,154 
55, 91,105, 155,91, 106 
6,146,101,24,97,152 











0,0,96,0,0,240,2 E 
32,240,255, 113, 248,127,113 
248,73,112,240,73, 244,95 
73,255,240, 73,255, 240,127 
225, 248,127,255, 252,68)1 
248, 255,255,240, 255,255, 240 
156,59,224, 34, 68,240, 95 

226,24, 73,196,108,65,130 
150, 34,68, 151,28,55,96 











ROCKET 


| TENDER 





CARRIAGE 








216,0,0,80,0,0,80 
0,0,80,32,128,82,33 
192,87,35,128,95,247,0 
95,254,0,88,41,0,95 
213,224,95,173,224,95,93 
224,111,189,224,17,93,224 
34,45,224,228,53,231,34 
40,56,32,32,68,32,32 
84,16)84,68,15,128,56 




















0,7,128,0,11,64,0 
23,160,1,28,224,5,28 
224, 15,151,160, 31, 203,64 
255,254, 98 
0,127,255 
95,0,6,127,255,254 
60,118,255, 255, 255,32 
129,4,35,129,36,32,129 
715,0,136,14,0,112 

















27,255,255,33,8,66,63 
255,254,51,156,230,33,8 
66,33,8,66,33, 0,66 
33,8,66,115,156,231,51 
156,230,51,156,230,51,156 
230,51,156,230,51,156,230 
63,255,254, 255, 255,255,7 
9,112, 8,128, 138, 10,128 
168,8,128,136,7,0,112 





“жан 
m 





TENDER 











PACIFIC-TYPE LOCO 











0,0,0,0,0,0,0 
1,255,1,131,254,15,255 
254,31,255,254,63,255,254 
48,0,2,47,255, 254,48 
0,2,47,255, 254,63, 255 

254, 63,255, 254,191,255, 254 
255,255,255,191,255,254,9 
38,144,22,219,104,22,21% 
104,9,36,144,6,24,96 









0,255,78,255 
255115,255,255,75,255,255 





75,0,0,126,255,255,127 
0,0,98,255,255,127,255 
(127, 220,14 ,127, 162,17 





165,32, 26,123,135, 36 
136:196,90,159,255,90,65 
32,36,34,17,24,28, 14 











0,31,128,0,15,0,0. 
15,64,9,255, 224,255,255 
224,255,255, 240,255,255, 232 
1,255, 232,255,255, 232,1 
255, 240,255,258, 224,255,255 
224,1,63,240,8,159,217 
144,255,255, 258,47,237,98 
36,146,252, 43, 199, 144,75 
104,0,132,146,7,3,12 




















RS TRUCKS AND MOTORBIKES C 

















VETERAN 











34,2,0,18,2,0,1Е 
6,0,10,14,24,10,12 
56,102,12,48;70;12,8 
131,252,8,135,254,17,15 
254,17,15,194,58,15,220 




















3,255,192,7,255,224,8 
0;16,8,0,16,16,255 
8;17;129,136,63,255,252 
127,255,254,127,0,254,204 
126,51,133,189,161,133,255 
161,204,0,51,255,253,255 
































15,240,0,15 
























































MOTORBIKE 








0,224,0,1,19 





135,96,19,255,192, 
64,50,245,32 
94,185,114,4 
27,254,153,3 
195,51,0,102,30,0,60 






























































0,0,224,0, 
4,225,0, 
224,0,1,250, 



















































































































255,255,255, 
255,255,255, 2 
255,255, 255,255 
255,255, 255,152 
















36,90,6,91,90. 
13640, 36,24, 















































































171,255,254, 171 
49, 244,172,232 
0,255,151, 250,252, 
74243431, 31,222,175, 255 
90,76 ,255,254,172,0,7 
28,0,3,248,0,1,240 







































































252,0,18,68,0 
0,19,194,0,11 
1,19,255,254 11,21: 
250,19,219,250 
35,250,91,255,186,165 
(219,128 
23610,72,24 







118, 192,125,114,192, 255,254 
192,231, 242,223, 219,239,217 
9,222, 213,230,179, 211,213 
18,173,217,231,243 
213,60,30,211,24,12,63 























































































































CARS, TRUCKS AND MOTORBIKES | 














SPORTS SALOON 





FORMULA 1 | 








223,15, 
31,249,255, 127,240, 255,99 
246,128,63,210,255,0,25 
128,0,31,128,0,15,0 











,9,0 
263 
1224,47,255 
112,127,252 
,124,252,255,248,124,0 
6,0,28 
192,0,15,192,0,7,128 












63,128,0,63,128,0,63 
188 , 248,255,190, 250,255,190 
250,228,127, 34, 229,225,174 
255, 254,255,239, 255,127,265 
#3, 191, 255,211,191, 245,03 

191,239,255, 127, 255,254,255 
229,225,174, 228,127,34, 255 
180,250,255,190,250,63,188 
238,63,128,0,63,120,0 




















































































































LONDON BUS 





0,0,0,7,0,0,66 





127,255,255,255,259,255,196 
33,19,196,33,19,196, 33 
19,255,255, 255,234,170, 
213, 85,95,255,255, 242,196 
33,18,196,33,18,196,33 
18;196,33,10,255,255,255 
252,255,207,251,127,183,244 
191,75,251,127,183,251,127 
183,4,128,72,3,0,48 








255,176, 


160,0, 
192,0,1,128, 





























24,0,194,111,0,34,237 
зі | 0,19,53,128,10,242,192 
7,191,96,30,185,224,46 





136,123,223, 248,85, 168,136 
91,216,138, 254,127, 255,133 
33,160,0,6 





















зе 





127,249,0,68,49,0, 68. 
4128,16,19,128,47,19 
128,16,147,128,60,177,32 
63,255,252,64,255,254,158 
112,6,101,55,254,63,183 
190,115,150,242,237,214,236 
222,215,222, 222, 215,191,237 
255,243, 115,131,51,127,128 
63,63,0,30,30,0,12 




































































BULLDOZER 



















0,2 
213,1,254,211,1,2 
3,1,50,217,1,50,213 
1,98,211,1,122,223,1 

118,255,125,114,192, 255,254 
231,242,192, 219,238, 
189,222,192,230,173,192,218 
173,192,218,173,192,231,243 
192,60,30,152,24,12,0 











10,0,16,1,0 
16,31,0,16,31,0,56 
1,0, 63,255, 0,53, 248 
120,0,243,240,0,210 
0,253.191,0,251,97 
1214,255,0,45,225,0 
21,252,0,109 
3,0,146, 
0,103,182,0,63,252,0 













































































,0,0,32,0,0 
0,0,32,0,0,112 
112,0,0,112,0 
112,0, 249,32,0,233 
255,0,255,255,0,224,1 
0,223,255,128,63,225,192 
127,258,224,191,252,112,109 
182,58,146,73,30, 148,73 
14109,182,14,63,252,15 


9,64,0, 
32,0,0, 
0,0,112 
224,112 







































































LINER | 


SUBMARINE 











127,144,3, 255, 248,23 
5,252 „47, 213, 126,104,255 
195,251,125, 252, 104,250,248 








YACHT 






















0,224,0,0,236,0,0 
236,0,31,253,128,21,85 

128,79,253,128,117,85,128 
127,255,128, 111, 255,128,123 
251,192,126, 254, 224,127,191 
176,127,239,232,127, 251,248 
127,254, 248,127, 255,188,127 
255, 236,103,255, 254,67,255 
254,73, 255, 254,84, 63, 254 



























16,0,0,112, 
0,9,120,0,0 


0,0,0,0,16,0,0 


0,120 
„12! 




















0,8,0,0,31,0,0 
0,0,0,48,0,0,15 

192,0,127,224,0,0,0 
0,240,0,0,15,240,1 
255,210,0,0,0, 1,240 
0,15,140,7,255,224 
0,0,0,15,240,0, 
15,192,31,255,128,0,0 
0,0,126,0,0,126,0 

















HOVERCRAFT 


HOVERCRAFT 





TUGBOAT 


























0,0,0,32,4,0,32 
4,0,24, 
240;40,5,192,8,1,248 l 
8,1,248,63,255,252,53 
85,42,51,85,92,127,25% 
254,127,255,254,0,0,0 
127,255,251,255,255,255,255 
255,255,255,255,255,127, 
354,63,255,252,63,255, 

















240,5 p 


0,0,0,4,66, 
129,64,1,0, 
92,5,0,16 

















32, 
28,3,1 
11,126, 





0,4,0,0,4,0,8 
3,138,4,5,118, 
128,1,7,210,2,128,208 
3,71,240,4,101,96,8 

30 16,127,254 ,63, 255 
254,127,255,254,0,0,0 
27,255,254 ,223,255, 25: 
5,248, 199,255, 240, 25. 
224, 











207 





























MAN О WAR 




















0,120,48.0, 
0,120,62,252 

























,64,0,0,96,32 
4,32,12,64,32,31 
48,31,64,96,31,152 





1192,57, 
42,128, 64,42,128,64 
28,95,254,135,241,143 
;192,0,1,96,0 
255,254,31, 255,254 




















0,0,0,0,16,0,t 
7,0,0,16,0,0,3 





























































































































































0,0,0,0,0,0,0 
0,0,68,68,0,34,24 
0,15,17,0,8,136,128 

4,66, 64,2, 24,32, 15 
255,248,250, 170,175,15,285 
248,2,34,32,4, 68,64 
8,136,128,17,17,0,34 
34,0,68,68,0,0,0 
5,0,0,0,0,0,0 



























1155, 136,056 







нини 
Шии 


Е 


49,254,95,1, 
11,252, 63,255 


























ANIMALS 














































































































































































































































































































































































































































































































ANIMALS 















































































































































































































































































































































































































































































































































































0,0,0,0,0,0,0 
0,0,64,0,0,163,252 
0,71,254,0,175,255,24 
31,255,144,63,255,160,63 
5,224,63,255,240,63,255 
8,63,255,254,63,255,254 
31,255,254,15,255,248,13 
247,6,6,6,0,6,4 
0,2,4,0,1,2,0 




















































0,30, 1 
128,49,135,192,96,1 
192,156,240, 192,216, 2s 
23,250, 32,63,252,0 
,7,252 
252,32,63,252,112,123,25 
216,241,224,156,240,192, 
,192,96,135,1 
,30,0,0,1 


H 
























































































































































mE 0,0,0,0,0,0,0 

图 0,0,0,0,0,3,0 
0,4,128,0,8,64,0 
8,40,0,8,16,0,10 
0,0,15,0,0,7,128 
0,15,202,0,15,239,0 
UEM] 15,253,128,7,255,128,15 
上 255,0,12,62 
192,8,28,0, 































































































96,00, 64,0, 


40;86,0, 254, 
236,13, 255,248 






























































































































































__BUGS AND SNAILS 


0,1,192,0,3,240,0 
7,248,0,15,252,0,30. 
62,0,23,223,0,61,239 
0,59,231,0,123,55,0 
122,166,0,246, 238,32, 246 
220,145 ,247,60,1, 235,248 
51,239, 248,115,239, 240,252 
223,192,127, 0,64,31,255 
8,7, 255,224, 3,255,252 




















4,0,64,2,0,128,2 








128,14,124,24,25,2 

19, 125,144,34,56, 13! 

16,136,36,0,72,4,0 
10,32 
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i 
2,4,128,0,4,48,128 
o 18, 76, 64, $9,133, 32,158 ; 
E 3,38,184,8,2,240,16 
1226,11 57,254, 33,129, 213,192,255 
223,112)15,255,224,7,223 6, 188,107,186 148,193, 63,255,193, 255,148 
112, 3,154,32,0,41,28 235,245, 16 192:127,211,192,57,254,32 
2,200,130,24,8,121,9 07,132,32,8,4,16,6 2i0,16;28,184,8, 32 
8/4,125,240,2,6,0 4,8,16,8,4,32,46 158,4,64,99,132,128,18 
1,8,0,0,0,0,0 361,0,0,0,0,0 16,3, 48,04, 128 
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0,56,0,112,56,28,140 
0,98,331,57,130,95, 

;24,56,48, 7,255,192 
125,128,12, 146,96, 16 


96,0,12,248,130,62, 206 
68,230,319, 41,182,209, 
22,81,187, 20,118, 186,220 
41,215 ,40,57,57,56, 22 
56,208, 24,186, 48,15,295 
224,2,56,128,15,255,224 | 
24, 186,48, 50,146,152,52 
147,88,51,147,152,25,17 
48,15,1,224,6,0,192 











5,100,48,16,24 
0,16,0,0,16,0,0 
16,0,0,16,0,0,16 
0,0,16,0,0,16,0 


0,249,192,1,130,160,2 
5,22,4,9,16,8,8 
136,16,8,64,32,8,0 





















































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































































40,3,193,1 
231,176, 

91,192,31, 
231,98,25,248,224 
192,0,83,128,0 

0,0,4,0,0,4 
,4,0,0,11,0 




















































































































































































































































































































































































































































































































CHARACTERS | 











SHERRIFF 














9,60,0,0,126,0,1 
255,128,0,125,0,0,126 
5,0,126,0,0,60,0 
7:119, 224,9,0, 144,18 
072,36,0,36,72,0 
18,143,0,5,255,255,255 
15,255,240,7,255,224,3 
231,192,1,231,128,3,231 
192,7,211,224,7,231,224 























,128,0,12 
4,0 
nti 
134,20,30,255, 7,252,255 





3,248,5 
224,17 





1240,68 
8,145,0,184 




















SHERRIFF 
0,7,128,0,15,132,0 
63,240,0,14,128,0,12 
64,0, 

0,5,5 
18 





130,128,10,130,132,6,254 
134,14,252,255,23,248,255 
59,540, 252,60, 243,68, 24 
127,170,24,62,145,12,24 








HUNCHBACK 





4128,0 


(0,0;126,0 
4223,9,3 












,0,0,0,3,128,0 
7,0,0,55,64,0,78 


32,0,132,54,1,16,64 












3,149,128,3,213,0,3 
246,0,3,246,0,1,216 
0,0,246,0,0,245,0 
0,252.0 о 
120,9.9,212,0,0 


40,0,92,0 















































0,0,0,0,3,128,0 
710,0,55,64,0,78 

32,0,132,64, 1,18,64 
3,149,128,3,213,0,3 
247,128,3,240,128 

128,0,254,0,0,125, 
0,251,0,1,247,0,3 
239,128,3,135,144,1,131 
240,1,129,240,0,192,192 











Т = Т 




































































































































































DWARF 











DWARF 

















0,248,0,11,240,0,7 
232,01,196,0,0,72 
0,0,32,0,0,72.0 
0,204,0,0,204,0,0 
204,0,0,66,0,0, 34 
2,0,92,0,0,68,0 
0,70,0,0,138,0,1 
8,0,3,235,64,1,135 
192,1,131,128,0;193,0 






















0,248,0,3,240,0,7 
232,0,9,196,0,0,72 
0,0,33,128,0,78,128 
0,152,128,1,63,0,1 
60,0,0,186,0,0,72 
0,0,56,0,0,72,0 
0,68,0,0,154,0,1 
18,0,3,235,64,1,135 
152,1,131,128,0,193,0 
































SHERRIFF 





0,7,128,0,15,192,0 
63,250,0,14,128, 
64,0,8,128,0,4,128 
0,5,96,0, 10, 144,0 
18, 136,0, 18, 68,0,2 
34,64,8,146,132,7,78 
134,18, 188,355, 31, 248,255 
§3,240,252,60, 2331 

95,170, 24,62,145,, 





12 

































224,8,134,64,4,138,0 
5,114,0,10,14 


15,1% 








0,60,0,0,226,0,1 
255,128,0,102,0,0,90 
0,0,66,0,0,126,0 
7,153,224, 5,60, 144,18 
126,72,36,126, 36, 72,69 
18,144,24,9,255,231,255 
15,255,240, 7,255,224,3 
231,192,1,231,128,3,201 
132,7,231,224, 1,231,224 











0,3,128,0,7,0,0 
55,64,0,78,32,0,244 
54,1,120,64,3,153, 128 
3,166,0,3,174,192,3 
222,64,0,355, 152,3, 127 








0,7,191,128,31,223,226 
63,231,254,56,0,252,24 
0,48,24,0,0,12,0 
0,0,0,0,0, 












































E „130, 
458,160,11 
011,255 























































6,64,8,130,32 
166,11,258, 160,11 


160,19, 255,144,9, 255,32 
1,255,0,1,239,0,1 
239,0,1,239,0,0,238 
0,1,239,0,3,171:12% 





5,160,11255,160,11,255 











































































































































































































CHARLIE CHAPLIN 











CHARLIE CHAPLIN 















0,48,0,0,121,192,0 
253,64,0,105,0,0,68 
128,0,72,192,0,33,160 
0,127,144,0,255,136,1 
255,4,1,252,2,0,158 
1,0,120,0,0,120,0 
0,124,0,0,188,0,1 
222,0;3,219,64,1,135 
192,1,151,128,6, 193, q 








































‚48,0, 
0,6 
7 





20,0,0 


,104,0,0,68 


2,0,0,32,0 





0,120,0,0,120,128,0 
155, 64,0, 
128,0,120,0,0,112,0 
0,112,0,0, 
240,0,1,112,0,2,96 
0,0,120,0,0,9: 


26,64,0,122 








12,0,0 






















0,48,0,0,120,0,0 
252,0,0,104,0,0, 68 
0,0;71,192,0,33,64 
0,121,0,0,252,128,1 
254,132,3,242,160,7,123 
144,6,120,8,0,124,4 
0,124,2,0,250,1,1 
216,0,3,239,64,1,135 
192,1,131,128,0,193,0 






































































TEA 





























0,0,3,0,0, 

0,15,0,0,62,0,0 

255,0, 1,255,043 

0,7,255,0,15,255, 

31, 255,208,63,255,248,127 

255, 29,208,255 ,15,224,6 

T 0,0,14,0 

0, 0,28,0,0 
10,55,0,0,113 
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WITCH BLACK CAT 
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| GAMES SYMBOLS 














BANANA | 


АРРІ.Е 








0,1,192,0,1,255 
0,127,0,0,54,0,0 
ер ИКИСИ 
9,1,176,0,1,165 
А 3,96,0,3,96,0,5 
224,0,14,192,0,61,192 
9,123,128,1,131,128,15 
223,0,126,62,0,129,262 
0,127,224,0,15,128,0 































> 






































17,0,2,170,128,2,68 
128,2,170,128,3,17,128 
2,170,128,2,68,128,1 
191,0,1,17,0,0,170 
0,0,198,0,0,123,0 














15, 239,57, 258,23) 
207,127,255, 13 
255,248,3,255,2 
240,0,127,224,0 













CLUB | 
0,16,0,0,214,0,1 (GS 0,56,0,0,1 
135,0,0,56,0,1,255 254,0,1,255,0, 
0,2,124,128,4,56,64 0,1, 255,0,0,2 
0,68, 0,0,170,0,1 0,124,0,7, 











57,224,31,187,240,63,255 
248,63,255,248,63,215,248 
31,147,240,15,87,224,7 
57,192,0,124,0,0, 124 
0,0,254,0,1,255,0 















































































































































































































































| CHERRIES 


STRAWBERRY 


BELL 








9,8,0,0,16,0,0 
16,0,31,39,128,63,175 
224,127,255,240,63,167,192 
31,80,0,0,136,0,1 
0,2,3,192,2,3 
32,7,7,48,12,143,248 
28,207,248,63,239,248,63 
231,240,63,227,224,31,193 
192,15,128,0,7,0,0 


























| 932,0,0,16,0,0 
16,0,1,255,0,1,255 











128,7,111,192,15,255, 
29,189,176,31,239,246 
254,176,27,219,240,31,255 
112,13,111,224,15,251,96 


6,223,192, 7,251,192,3 
127,128,1,239,0,0,254 
0,9,124,0,0,56,0 




















0,24,0,0,126,0,0 
249,0,1,240,128,3,240 
64,7,224,22,7,224,)2 
2,424,32,7,324,32,1 
224,32,7,224,32,7,224 
32,15,192,16,31,128,6 
31,128,8,31,255,248,0 
52,0,0,52,0,0,24 
0,0,0,0,0,0,0 

















DIAMOND 











ROOK 

















0,16,0,0,16,0,0 
56,0,0,56,0,0,124 
0,0,124,0,0,254;0 
1,255,0,3,255,128,7 
255,192,15,255,224,7,255 
192,3,255,128,1,255,0 
0,254,0,0,124,0,0 
124,0,0,56,0,0 
0,0,16,0,0,1 





















241,128,7,251,128,3,255 
9,7,249,118,15,255,192 























HEART 





KNIGHT 





BISHOP 


2,0,0,0,0,0,6 
205,128,6,205,128,7,243 
128,7,241,128,1,254,0 
1,250,0,3,243,0-1 

| 250,0,1,250,0,1,250 
5,1,250,0,1,250,0 
1,250,0,3,253,0,7 

| 241,128, 7,251,128,3,255 
| 0,7,249,128,15,255,192 








3,1,128,7,131,182,15 
199,224,31,199,240,62,239 
248,63,239,248,63,255,248 
53,255,268, 21,255, 240,15 
255,224,1,255,192,3,255 

128,1,255,0,0,254, 
0,254,0,0,124,0,0 
124,0,0,56,0,0,56 
0,0,16,0,0,16,0 



















0,8,0,0,56,0,0 
220,0,1,250,0,3,249 
6,0,253,0,1,61,0 
9 0,1,250,0,3 
242,0,3,228,0,1,252 
0,0,120,0,1,238,0 
1,250,0,3,253,0,7 









0,48,0,0,48,0,0 
120,0,0,252,0,0,124 
0,1,56,0,3, 157,0 








































































































JOKER 


KING 



































6,60,0,0,195,224,1 
64,48,2,36,16,4,31 
76,4,31,224,12,223,144 
29,51,116,62,16,112,126 
68,130,126,170,226,118,0 
94,100,0,67,68,40,67 
196,16,64,194,130,128,2 
108,128,1,17,0,0,130 
0,0,68,0,0,56,0 

























0,120,0,0,180,0,0 
252,0,0,252,0,6,181 
128,15,51,192,15,255.192 
15,255,192,7,255,128,3 
255,0,1,250,0,3,253 
0,1,250,0,1,250,0 
1,250,0,3,253,0,7 
241,128,7,251,128,3,255 
0,7,249,128,15,255,192 


























2,49,0,7,123,128, 
19,0,1,122,0,3,255 
0,1,254,0,3,255,0 
1,250,0,1,250,0,0 
244,0,0,244,0,0,244 
0,0,254,0,0,244,0 
1,254,0,3,253, 
241,128, 7,251,128,3,255 
0,7,249,128,15,255,192 



































PALM TREE | 












112,0,14,208,0,11,144 
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(225.1 











0,9,232,255,23;21,129 | 155,224,99,190 
168,11,0,20%,6,0,56 260,159,255, 26 
2,0,64,2,0,64,2 63,205,120,115,228,113 

à 231,64,2,231,64,2,0 | +196,195,145,226,135,16 





64,1, 24,128 
5,219,160 

123,40,232, 
9,208,0,11,112,0,14 





34144,32,70,16,16 
5,4,48,0,0 






















































































ARROW 

















0,8,0,0,20,0 
31,0,0,65,0,0 
128,1,0,53,2,0,32 
4,0,16,15,0,120,31 
0:112,63,0,96,7,0 
64,7,0,64,7,0,64 

7,0, 64,7,0, 64,7 
0,64,7,0,64,7,255 
152,5,555,158,7,255,0 




































































































































































































1,199,0,3,193,128,3 
239,128,7,239,192,31,239 
240,63,233,248,61,219, 248 
0,15,255,224, 
255,224, 51,255 
39,248,63,215,248 
31,215,240,7,147,192,3 
147,128,3,33,128,1,33 
2, 


224;21,221,192,19,187,128 
12,119,0,16,238,0,15 
32,0,24,56,0,28,1 
9,51,224,0,0,0,0 








60,1,85,64,3 
,34255,124,7 
55192,15, 








264,0, 





261,9 
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0,36,160,0, 
1:0,0,0,6,0,0 








248,38,255,240, 61,255,240 
52,255,224,126,227,192, 78 
36, 240,180,33,16,180, 82 
32,72, 40,64, 48,20,128 











TROLLEY 


FROGMAN 














54:152,1 
24,16,72,60, 
33,204,126,97 
243,255,207,14 
0,72,45,0,180, 
160,18,0,72,12, 



















48,0,0,48,0,0,33 
2,50,128,192,60,96 
24,48,32, 86,56 
48,25, 108,40, 24,140,326 
24,20, 68,60, 16, 132,60 








243,255, 207,140,0,49, 
0,72,45,0,180,45,0 
180,18,0,72,12,0,48 

















BMX RIDER 


BMX RIDER 

















0,56,0,0,40,0,0 
16,0,0,198,0,1,147 
2,3,57,128,0,55,0 
7,69,192,0,56,0,0 
22,0,0,22,0,0,198 
0,0,214,0,0,214,0 
0,208,0,0,214,0,0 
56,0,0,208,0,0,16 
0,0,16,0,0,16,0 























0,56,0,0,40,0. 
16,0,0,198,0, 1,147 
9,3,57,128,0,5Е,0 
2.69,192,0,56,0,0 
208,0,0,208,0,0,198 
2,0,214,0,6,214,0 
0,22,0,0,214,0,0 
6,0,0,22,0,0,16 
,9,16,0,9,16,0 



























2 
255,128,1,129,128,3,60 
192,3,60,192,4,207,22 
11,15, 208,28,15,248, 40 
15,244,68,15,226,112,15 
225,2,15,192,2,15,192 




























programs. If you have not used a routine before, it is 
recommended that you read the introduction to the 
routine on the appropriate page of the book before using 
it in your program. 


The table shown below gives a summary of all the 
machine-code routines used in this book. This table does 
not explain every detail of using each routine; it is 
intended only as an aid when using the routines in your 


























sprite buffer 











B 






24х21 sprite editor 


Епа0-с0 





character 





15 


sprite print 





print position 





16 


master sprite 


ENT (x.y.0) 





17 


sprite handling 





FNgG.y,GLs,c,0) 


Xy start co-ordinates: 
d direction 
1 distance to be moved. 


s switch 
c collision flag 
n sprite number 


pixel 


pixel x3 








21 


keyboard-controlled sprite 


interrupt vector table 


FNh(s,x,y,c,n) 


8 switch 

ху start co-ordinates 
c collision flag 

n sprite number 





22 


23 


double horizontal sprite 





FNi (x. y.d.l,s.c,n) 


х,у start co-ordinates 

d direction 

1 distance to be moved 
switch 


collision flag 
sprite number 





double vertical sprite 


FNj(x,y,d.1,s,c,n) 


s 

© 

n 

ху start co-ordinates 

d direction 

1 distance to be moved 
switch 
collision flag 

n sprite number 


pixel 
pixel x3 





25 


sprite animation 


ЕМЕ (x,y,d,l,s,f,c,v,n) 


xy start co-ordinates 
d direction 
1 distance to be moved 


switch 

number of frames 
collision flag 
animation speed 
sprite number 


pixel 


pixel x3 





29 


horizontal scroll 


FNI (d) 


length of scroll 
direction 





29 


vertical scroll 


 FNm(ld) 


length of scroll 
direction 


pixel 





31 


window 


FNn(x,y,Ln,d,r) 


start co-ordinates 
width of window 
sprite number 
direction 

repeat flag. 


character 
character 





33 





interrupt-driven window 


FNo(s,x,y,1,n.d,r) 


switch 

start co-ordinates 
width of window 
sprite number 
direction 

repeat flag 


ан канвы хе в 0-2 
< < 


character 


character 
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Before using a routine, you must first define it in your 
program using DEF FN followed by the correct number 
of parameters. Parameters passed to machine-code 
routines must always be whole numbers; if a parameter 
value is calculated by your program, then put an INT 
statement in front of it to ensure a whole-number value 
is passed to the routine. 









0-28 and 0-20 
1-10 

0-231 and 0-154 
0-3 

0-51 (vertical) 
0-77 (horizontal) 
0-1 

0-1 






365 53700. 






-1 
-231 and 0-154 
2 
-10 


256 


52736 














0-231 and 0-154 
0-51 (vertical) 

0-77 (horizontal) 
0-1 
0-1 


235 


7 52400 53 








0-231 ап40-154 230 52100 20 
0-3 

0-51 (vertical) 

0-77 (horizontal) 

0-1 


0-1 





0-231 and 0-154 
0-3 

0-51 (vertical) 
0-77(horizontal) 


275 51700 63 





190 51500 61 





215 50900 47 





290 49600 43 
0-31 

1-10 

0-1 


0-1 





0-1 

0-31and 0-21 
0-31 

1-10 

0-1 

0-1 


315 49200 154 








MEMORY MAP 
































This chart shows how the Spectrum memory is organized when all 
the routines are present in memory. RAMTOP can be set to 49000 
using a CLEAR command. 

routine title address 
lowest book 3 routine 55500 
sprite buffer (700 bytes) 54600 
FNa- FNe 24 x 21 sprite editor. 54200 
ЕМ sprite print 54100 
master sprite 53700 
FNg sprite-handling 53500 
FNh keyboard-controlled sprite 53100 
interrupt vector table 52736 
— 
FNi doubie horizontal sprite 52400 
ЕМ] double vertical sprite 52100 5 
FNk sprite animation. 51700 
| 
| FNI horizontal scroll 51500 
FNm vertical scroll 50900 

| 

| 

| FNn window 49600 

| FNo intermupt-driven window 49200 

| 

| RAMTOP (after CLEAR 49000) 49000 

| 











ним Е BÓ 














Main entries are given in 


bold type 


Aircraft 40-1 
Aliens 36-7 
Animals 48-50 
Animation 24-7 
Animation 
program 25-7 
Automobile 


program 22-3 


BASIC 6 
BASIC programs 
adapting 9 
loading 9 
Batprogram 19 
Birds 52 
Boats 46-7 
Bugs 51 


Cars 44-5 
Characters, 

human 54-5 
CLEAR 8 

Cockpit program 30-1 


Dinosaurs 56 
Displaying 
sprites 14-15 
Double horizontal sprite 
routine 22 
Double vertical sprite 
routine 23 
Double-sized 
sprites 22-3 


Errors, while keying 
in 9 


FNa 11 
FNa-e 13 
FNb 11 
FNe 12 
FNf 14, 15 
FNg 16-17 
FNh 20-1 
Емі 22 
ЕК) 23 
ENk 25-7 
FNI 28-9 
FNm 28-9 
FNn 3l 








FNo 3 
Functions 9 
Games symbols 58-60 
Horizontal scroll 
routine 28-9 
Human characters 54-5 
matchstick men 61 | 


Interrupt-driven window 
routine 33 
Interrupts 16-17 


Keyboard-controlled 
sprites 20-1 
Keying in sprites 35 


Loading 

BASIC programs 9 
machine code 8 
Lorries 44-5 


Machine code 6 
adapting routines 9 


disadvantages 6 
loading 8 
routines 6-7, 62 
using 8-9 


Master sprite routine 16 
Matchstick men 61 
Memory 

clearing 15 

map 63 

storing sprites 15 
Motorcycles 44-5 
Movement, creating 10 


Phantoms 39 


Railway trains 43 
RANDOMIZE 9 
Repeating sprites 30 
Routines 6-7 
adapting 9 
checklist 62 
saving 8-9 

using 7 


SAVE 8 

Screen scrolling 28-9 
Scroll routines 28-9 
Sea creatures 53 





Ships 46-7 
Snails 51 
Spacecraft 38, 42 
Spectres 57 
Spooks 57 
Sprite directory 
aircraft 40-1 
aliens 36-7 
animals 48-50 
birds 52 
boats 46-7 
bugs 51 
cars 44-5 
characters 54-5 
dinosaurs 56 
game symbols 58-60 
matchstick men 61 
motorcycles 44-5 
phantoms 39 
seacreatures 53 
ships . 46-7 
snails 51 
spacecraft 38,42 
spectres 57 
spooks 57 
trains 53 
trucks 44-5 
using 35 
Sprite editor 
program 
routines 
Sprites 10 
animation 
routine 24-7 
displaying 14-15 
double-sized 22-3 
handling 
routine 16-17 
implementing 10 
keyboard 
controlled 20-1 
keying in 35 
moving 16-19 
print routine 15 
repeating 30 
storing 15 
Storing sprites 15 


11-13 
11-12 
11-13 


Train program 18-19 
Trains 53 


Trucks 44-5 
Unicycle program 7, 23 


Vertical scroll 
routine 28-9 











Wildlife program 
Window game 
program 32-4 
Window routines 30-4 
Wrapround effect 28 
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The bestselling teach-yourself Lee amming course now offers the 
first complete full-colour on creating sprites on the 
ZX Spectrum. 
















Illustrated with over 300 screen-shot photographs, it contains 
programs for single and double sprites, for animation, and for 
上 十 setting overlaps and detecting collisions, and includes an easy-to- 
use sprite generator with which you can design and save your own 
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THE DK SCREEN-SHOT PROGRAMMING SERIES 

Books One and Two in the DK Screen-Shot Programming Series 
brought to home computer users а new and exciting way of 
learning how to program in BASIC. Following the success of this 
completely new concept in teach-yourself computing, the series 
now carries on to explore the speed and potential of machine-code 
graphics. Fully illustrated in the unique Screen-Shot style, the 
series continues to set new standards in the world of computer 
jooks. 


BOOKS ABOUT THE ZX SPECTRUM+ 

This is Book Three in a series of guides to programming the ZX 

Spectrum+. It contains a complete BASIC-and-machine-code 

graphics language for the Spectrum+, and features its own 

graphics editor which enables you to use all these facilities directly 

rom the keyboard. Together with its companion volumes, it builds 
up into a complete programming and graphics system. 





ALSO AVAILABLE IN THE SERIES 


Step-by-Step Programming for the Commodore 64 
Step-by-Step Programming for the BBC Micro 
Step-by-Step Programming for the Acorn Electron 
Step-by-Step Programming for the Apple Пе 
Step-by-Step Programming for the Apple Ис 














PIERS LETCHER 
After graduating with a degree in Computer Systems, Piers 
Letcher has worked in many areas of the computer industry, from 
programming and selling mainframes to designing and marketing 
educational software. He was pereo Fditor of Personal 
Computer News until May 1984 and has since written a guide to 
peripherals and a number ofother books for popular home micros. 
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The Sinclair Spectrum is one of the most popular 
microcomputers ever produced. One reason for its 
success has been its remarkable ability to produce 
graphic displays rivalling those produced by much 
larger computers designed only ten or fifteen years ago. 
However, graphics programming in BASIC under- 
utilizes the Spectrum. To produce the kind of displays 
seen in commercially available games, you need to use 
machine code as well as BASIC. | 


What is machine code? 

The heart of the Spectrum, the Z80 central processor, 
cannot understand BASIC. A BASIC program must 
first be translated into a simpler language that the 
machine can understand (hence the term “machine 


code”). This code is in the form of binary 1s and 08. | 
Before the processor can execute a BASIC program | 


line, all keywords and variables are first converted to 
machine-code instructions. 

BASIC is an example of what is known as an 
“interpreted”, as opposed to a “compiled”, language — 
that is, it is executed by the central processor line by line 
rather than as a complete program. While an 
interpreted language is easier to use, it is also slower in 
execution. By writing programs in machine code, you 
can miss out the BASIC interpreter altogether. In 
addition, machine code allows you to utilize many 
features of your Spectrum which cannot be reached 
from BASIC, so that you can therefore achieve far more 
impressive results than would ever be possible from the 
simpler, but more restricted, BASIC. You can get an 
idea of how much faster machine code is by seeing the 
time taken for the programs in this book to run. 


Disadvantages of machine code | 
Given all the advantages of machine code in both speed | 
and flexibility, why not ignore BASIC and use machine 
code all the time? The answer is simply convenience. 
Using machine code is time-consuming, difficult and 
frustrating, and attempting to write your own code is 
only for the expert. When you see machine-code listings, 
they are usually in a “disassembled” form, that is, with 
some of the numbers translated into mnemonics such as 
LD for LOAD, and JP for JUMP. But a special 
disassembler program is required simply to give you a 
machine-code listing in this form, and these mnemonics 
are themselves far from simple. Using machine code 
even the simplest operations in BASIC, such as drawing 
a line on thescreen, require many lines of machine code. 
In addition, machine code has no error-trapping | 
routines such as those in BASIC. If a mistake is made 
when keying in a BASIC program, the program willnot | 
be lost (although the program may refuse to RUN at | 





routines, a mistake will probably cause the Spectrum to 
crash, erasing both the program and its DATA. 


The solution 

This book combines the advantages of machine code 
with the convenience and simplicity of BASIC. This is 
done by giving the machine code in the form of ready- 
made and tested routines, which you can then use in 
your BASIC programs. The machine code is shown as 
DATA statements in BASIC, which means it isn't 
necessary for you to understand anything about 
machine code to be able to use the routines. The DATA 
is given in the form of decimal numbers, rather than in 
binary or hexadecimal (to base 16), so that the machine 
code is in the form most convenient for you to read and 
key in. 








The machine-code routines 
Here is an example of a machine code routine (the 
point-plot routine, FNf, from page 17): 








73850 LET ь-61508: LET (-бо: LET 
Z=8: RESTORE 7360 

7351 FOR i=8 TD 1-1: READ a 
7352 POKE (b+i) ,3: LET z=z+a 
2353 NEXT i 

7354 LET zzINT (IZ/U -INT (270) 
m 

7355 READ a: IF a«»z THEN PRINT) 
#332". STOP 

2360 DATA 42,11,92,1,4 

7361 бата 0,9,86,14,8 

7362 DATA 9,94,62,175,147 

2363 DATA 216,95,167,31,55 

7364 DATA 31,167,51,171,230 
2365 DATA 248,171,103,122.7 
7366 бата 7,7,171.290,199 

7367 DATA 171;7,7,111,122 

7368 DATA 230,7,71,4,62 

2869 бата 254,15,16,253,6 

2378 DATA 255:168,71,126,176 
7371 DATA 119;201,0,6,0 

7372 DATA 24,0,8,0,0 











Each routine in the book is shown like this, in the 
form of a BASIC program. The machine code is 
contained as a series of DATA statements in lines 7360- 
7372. At the beginning of the routine in lines 7350- 
7355, there are a few lines of BASIC. This is a loader 
program; variable b tells the computer where in mem- 
ory to begin loading the routine, and variable | the num- 
ber of bytes in the routine. When the loader routine is 
RUN, this routine is placed in memory from address 
61500 onwards, and has a length of 60 bytes. 

As shown here, of course, the routine is simply a list of 
numbers, and has no visible meaning. These numbers 
are the ready tested and assembled machine code which 
has then been converted to a sequence of decimal 
numbers. Each number corresponds to a single 
instruction or item of DATA required by the routine; 








E) 


hence, all the numbers have values between 0 and 255, 
the maximum value of a byte. All you need to know 
about the routine is what it does and what information it 
requires so that you can call it correctly from your 
BASIC program. 

All the routines in the book are defined as functions. 
Each function is individually coded by the letters a tot; a 
complete list of functions is given on pages 60-61. 
Demonstration BASIC programs can be found on the 
same page as the routine, which give an indication of the 
kind of displays possible using the machine code. 


How to use the routines 

To use any program in this book, simply key in a 
machine-code routine together with a BASIC program 
which demonstrates its usc. You will find full details of 
how to do this on pages 8-9. When you RUN the 
program, you will immediately begin to see the true 
power of your Spectrum. 

As you progress through the book and the range of 
routines grows, the BASIC programs grow too by 
calling several routines to produce increasingly complex 
graphics. By keying in each routine just once, and then 
SAVEing it onto cassette or Microdrive, you will have a 
sophisticated graphics capability at your fingertips. 


The programs in use 
Atypical program from this book (the exponent curves 
program on page 17) contains two details which will be 
unfamiliar to BASIC programmers who have not used 
machine code before: 

EXPONENT CURVES PROGRAM 








E PN біх,у)жизп 61500 
8 BEROEN L'URABER OR. INR e 
FOR n=1.19 TO 1.60 


FOR х=0 TO 22 STEP 9.5 

LET z-INT (ХРП) 

СЕТ Ә-ІМІ (Хеб) 

RANDOMIZE FN fizy) 

RANDOMIZE FN ғ(255- 
D 


c 
STEP а.е 


M 
M 2, 
x 
n 





First, you will see in line 10 a DEF EN statement, which 
is used to instruct the computer that a machine-code 
routine with two parameters (x and y) is located at 
address 61500 in memory. You will also notice two 
RANDOMIZE ЕМ commands (lines 150 and 160). 
These are the calls to the point-plot routine, and the 
numbers in brackets which follow them are the 





parameter values to be passed to the machine-code 
routine (in this case, the co-ordinates of the point to be 
plotted). When RUNning, the program is carried out by 
the computer in this way: 





POINT-PLOT PROGRAM FLOWCHART 














(ву) 





| routine plots point at 
у 
NS 








| routine plots point at 
| (255-2,168-у) 


















On the left side of this diagram is the main BASIC 
program, and on the right you can see the machine-code 
routines, called twice using a RANDOMIZE FN 
statement. You will see from the diagram that the 
machine-code is used here very much as a subroutine 
would be used in BASIC, with variables passed to the 
routines each time they are called. 


What the routines do 

Much of this book gives you machine-code versions of 
the graphics commands you are familiar with in BASIC. 
You will find that the machine code is often many times 
faster, and offers you alternative ways of producing 
graphics which will often be preferable to the BASIC 
method. 

In addition, several routines are included in this book 
which would simply not be possible in Sinclair BASIC, 
such as magnification and reduction, and filling in 
irregular shapes with the current INK colour. 


The graphics editor 

To make the machine-code routines in this book even 
easier to use, all the routines contained on pages 10 to 41 
have been combined in a single program to form a 
complete package of routines, which you can use as a 
graphics editor (pages 42 to 51). No knowledge of 
BASIC is required to use the graphics editor; even 
someone with no knowledge of programming, and who 
has never used a Spectrum before will quickly learn how 
to produce sophisticated displays using this graphics 
editor. 








USING THE MACHINE CODE 








The machine-code routines in this book can easily be 
incorporated into your BASIC programs without you 
having to understand the intricacies of how they work. 
Simply choose a program from this book, and follow the 
four steps given here. 


1: CLEAR memory 
As soon as you switch on the Spectrum, type CLEAR 
55500. This command resets RAMTOP, the top of the 
area in memory free for BASIC programs, and ensures 
that BASIC programs cannot overlap with the machine 
code (stored in memory from 55500 upwards). Now you 
can safely use NEW to delete BASIC programs without 
deleting any of the machine code in memory. 
Remember to use CLEAR before loading machine 
code, since this command erases whatever isin memory 
above the specified address. 


2: Load the machine code 
Now type in whatever machine-code routines are 











Address in memory at which 
routine is located 


Other machine-code routines 

which must be present in 
memory for this routine 
to work 


three points. 


Usin 


List of parameters used by the 





Start address 60300 Length 80-bytes— 
her routines-eatled Line draw routine (FNg). 
Whatit does Draws a triangle given the 


the routine The routine uses absolute co-ordinates. 
Specifying off-screen co-ordinates produces- 


am 
message; values more than 255 pixels off the screen will 





required by the BASIC program. After keying in the 
routine, RUN the short BASIC program which 
accompanies it: this loads the code into memory. If you 
keyed in the DATA correctly, you will see an “OK” 
message on the screen; if not, you will see a couple of 
question marks. In this case, look again at what you 
have typed in to trace the mistake. 


3: SAVE the routine 

When you are sure you have keyed in the routine 
correctly, SAVE it onto cassette or Microdrive. Always 
SAVE machine code before using it, to minimize the risk 
of losing everything you have keyed in. When BASIC 
errors occur, an error message is usually produced but 
the program is not lost. Machine-code routines, 


however, do notgenerally have error-trapping facilities, 
and a fault in the code will as often as not cause the 
Spectrum to crash — deleting everything in memory. 
The machine code can be SAVEd in two ways: either 
in the form of DATA statements like any other BASIC 


Routine title (a single letter) 


Name of routine 


Number of bytes in memory 
taken up by routine 


Purpose of routine 





error - = 
Points to note when using 





routine, and letters used to 








describe these parameters 








probably cause the Spectrum to crash. Colours are set by the therontine 
current screen INK attributes. 
DEF FNi(x,y,p,qr's) 
Xy specify first corner of triangle.(x«—256,y«7176) | What the parameters do 








Pa 


specify second corner of triangle (p<256,q<176}—]__ 


Maximum and minimum values 














ns specify third corner of triangle (г<256,5<176) 


of parameter to ensure the routine 
does not plot off-screen points 





BASIC loading routine for 















machine-code DATA 

Start address for POKEing owe Ler ь-воөзәс LET 1-7?5, СЕТ 
z-e 7610 

DATA 7601 FOR i-O TO \-1. READ а 





(bei) 





POKES byte value a into 7604 LET z-INT 


location (bH) 





Start of machine-code DATA 








2612 


сета 


. LET z-z*a T Тгалтаса TER 
м Calculates check digit 2 
(Cz aru | 


уж 
7605 READ а. IF assz ТНЕМ PRINT 
2427. STOP 


© DATA 42,11,92,1,4 
Felt DATA 22515521418 
9594,237,83,208 
235,5.85,3,94 
537,83,2190,235,3 








READs next DATA item, the 
routine check digit; if this is not 
the same as z. two question 
marks are PRINTed to show a 
mistake has been made 














are) Ee) 


listing, or, after you have loaded it into memory, as a 
block of code. To save machine code, type: 





SAVE “routine name” CODE start address, length in 
bytes 





The start address and length are given at the top of each 
machine-code box. The diagram on the facing page 
shows how this information is displayed. 


4: LOAD a BASIC program 

With the machine-code routine in memory, you can now 
use it in a BASIC program. DEF FN statements are 
used to tell the Spectrum the whereabouts of the routine 
in memory, and what information the routine requires. 


Using functions 

A machine-code routine can be called simply by 
specifying its start location, like this: 

10 RANDOMIZE USR 63000 


Aline like thisin a BASIC program, however, is not very 
informative. It tells you neither what the routine does, 
nor how many parameters the routine may require 
when called. This information could be POKEd into the 
appropriate memory locations — but the consequences 
of a mistake would be disastrous. Much more reliable is 
to pass information to the routines using a BASIC 
function. Functions on the Spectrum are identified by a 
single letter, and are followed by parameters in 
brackets, When you define the name and location of the 
function in your program, you must also specify the 
parameters, if any, which are to be passed to the routine. 
For example, the screen clear routine, FNa, requires 
four parameters 


10 DEF FN a(x,y,h,v) = USR 63000 


Which letters are used after DEF FN is not important: 
their function is only to tell the computer the number of 
parameters which will follow the routine call ina BASIC 
program. 

A machine-code function can be called from BASIC 
in two main ways, both of which require you to combine 
the keywords FN or USR with a BASIC keyword. 

The method used generally in this book is with the 
keyword RANDOMIZE. Thus, 


RANDOMIZE EN a(10,10.10,10) 


would clear a rectangular area of 10x10 characters with 
the top corner at point 10,10. Note that using 
RANDOMIZE also resets the random number 
generator with a new seed; this may cause problems if 
you are also using a random function in your program. 

The second word you can use to call machine code is 
RESTORE. However, RESTORE also resets the 
pointer to DATA statements when you use it — which is 
of course the purpose of the RESTORE statement. If 























you opt to use RESTORE instead of RANDOMIZE 
then be especially careful if there are any READ or 
DATA statements in your program. 





QUESTIONS AND ANSWERS 








What if I make a mistake in keying in? 

Don’t panic! Nobody keys in long lists of numbers 
without making any mistakes. A check routine is 
included with each machine-code routine to warn you if 
you made any mistakes in keying in the DATA. This 
routine compares the DATA you have entered with a 
check number, which is placed by itself on the last 
DATA line of each routine. 

After the loading program has POKEd the DATA 
numbers into memory, it looks to see if the check digit is 
the same as the one currently calculated. If the two 
numbers are different, the program prints two question 
marks to show an error has been made. If this happens 
look through the numbers you have typed in to find the 
mistake. Having corrected the error, you may still find 
that the routine fails to load correctly; look to see if you 
have made more than one error. 


Can I start anywhere in the book? 

Yes, you can start on any page, but obviously when you 
key in a program it will not RUN unless the machine- 
code routine it calls is present in memory. Check before 
you begin if the program you want to RUN calls any 
machine-code routines you haven’t already keyed in. 


Can I use more than one machine-code routine 
in my programs? 

Yes — you can use any combination of routines from 
this book together. The complete graphics editor 
program (pages 42-51) provides a convenient way of 
using machine-code routines together in a single 
program. 


Can I adapt the BASIC programs? 

Yes. You can edit the BASIC programs in any way you 
want to produce different displays, and you will find 
suggestions for variations throughout the book. One 
suggestion, though, if you are going to experiment with 
unusual or off-screen values for the machine-code 
parameters, is to SAVE what you have keyed in before 
experimenting. This will prevent you from losing hours 
of work at the keyboard! 


Can I adapt the machine-code routines? 

Yes, but at your own risk! Without a good 
understanding of machine code, itis highly unlikely that 
you will be able to alter any of the routines successfully. 
Much more probable is that the Spectrum would crash, 
with the result that both program and code are wiped 
from memory. 
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SCREEN COLOURS 1 





The Spectrum CLS command 15 used to wipe off any ink 
from the screen, leaving the PAPER and INK attributes 
for the screen unchanged. 

However, there are often occasions when you may 
want to clear a portion of the screen without disturbing 
the rest of the display. The partial screen clear routine, 
FNa, enables you to do this. It clears any rectangular 
portion of the screen, leaving the PAPER and INK 
attributes at their current setting. It is used in a program 
by first defining the function (as in line 10 of the 
program below), and then calling it with a 
RANDOMIZE FNa statement (line 160). 








Colours on the Spectrum 

The Spectrum screen colours are set by the familiar 

INK and PAPER commands. However, although each 

character square on the Spectrum can have one INK 

and one PAPER colour, a command such as INK 2 
PARTIAL SCREEN CLEAR PROGRAM 





6-995669 56. 


affects the whole screen, even though you may only 
want the command to affect a small area. How can this 
be done? It is possible to change the INK attribute of a 
single character square on the screen by PRINTing 
spaces in graphics mode and using OVER, or by finding 
the relevant memory location of the INK attribute, and 
POKEing the new value, but these would be very slow 
methods of changing the INK colour on more than a few 
squares. 


Changing colours with machine code 

The window ink routine allows you to change the INK 
colour of any rectangular area of the screen. Whatever 
you draw on this area of the screen will now be in the 
INK colour specified by the routine, while outside this 
area, colours remain in the current Spectrum INK 
colour. The routine also allows you to set the BRIGHT 
and FLASH attributes of the area you are specifying. 


WINDOW INK PROGRAM. 





EF FN bix, yh, v, C, b, Fi at 
ORDER о PAPER а 
©. то тез 
«s 


INK а: с 


нынаныыныноьй 
6: 004 TURONE ONE 
895595585959 906 


,9,2,22 


қ: 






































Start address 63000 Length 100 bytes 
What it does Similar to BASIC CLS command, but clears only a 
specified rectangular portion of the screen. 


Using the routine Parameter values in this routine represent 
character positions rather than pixel positions. As with all the 
machine-code routines in this book, parameter values must be 
whole numbers. 

If the result of adding x and his greater than 31, or if the sum of 
y and vis greater than 23, the area to be cleared will run off the 
Screen, and the routine may crash as a result. 
































DEF FNa(x y,h,v) ] 
Xy specify top left-hand corner of area to be cleared 
(x<32, y «24) 
hv horizontal and vertical size(x th<32, ytv<24) 
ZOE LET b-63000 КЕТ 195: LET 
zz 
7001 е TO 1-1 RERD a 
z022 btid,a: LET х=х+а 
7003 NEXT i 
7004 LET z-INT (туі) -INT (2/00 
Fre 
7005 READ a: IF а<>: THEN PRINT 
"TU: STO 
7010 OATA 42,11,92,1,4 
2911 DATA ә,3,56,1,8 
7012 DATA 0O,9,94,2237,83 
2013 DATA 116,546,9,56,9 
7014 DATA 94,557,53,118,246 
7015 DATA 237,81.116,546,123 
7916 DATA 254,23,240,257,03 
2017 DATA 116:246,123,230,24 
7018 DATA 346,64,105,125,250 
7019 DATA 7,183,31,31,31 | 
7020 CATA 31,130,111,58,118 | 
2021 рата 216,71,197,229,6 
7022 DATA 8,197,229,58,119 
7023 DATA 246,71,175,119,35 
7024 DATA 16,252,225,193,36 
7025 DATA 16,240 ,225,195,62 
2026 OATA 32,133;111,48,4 
2057 DATA 52:6,152,163,16 
028 DATA 222 ,201,0,0,98 
7029 DATA 52,0,0,0,0 











Start address 62800 Length 135 bytes 








While the standard Spectrum screen graphics area is 
22 characters deep, with two lines reserved below this 
for text (lines 23 and 24), both the routines on this page 
can be used anywhere within the whole screen area, 32 
characters wide by 24 deep. 

The two programs on the facing page demonstrate 
the machine-code routines in action. Both programs 
begin by PRINTing a graphics character over the whole 
screen (lines 110-130). The partial screen clear program 
then clears five rectangular areas on the screen. The 
result is that the INK is deleted in these areas, while the 
paper colour remains unchanged. The window ink 
program calls the ink routine in two loops eight times 
across and down the screen, producing a grid effect. 








What it does Sets the INK colour of any specified part of the 
screen. 


Using the routine Be careful that you do not try to set the ink 
colours of points off the screen. Since parameters h and v are 
added to x and y respectively, this means that x+h should not 
be greater than 31, and у--у should not exceed 23. If they do, 
you may crash the Spectrum and lose the program you were 
working on. 

If, when using the routine, it appears that nothing has 
happened, then either you have set the INK colour to what it 
was already, or the area you have altered contained no INK 
attributes. Try the routine again after printing something in the 
specified area. 

Note that the routine can set the ink colour over the whole 
Spectrum 32x24 character screen, not just over the normal 
32x22 graphics area. 








uates E geo 





[ DEF FNb(x,y,h.v,c,b.f) 














Г ху specify top left-hand corner of box area (x<32, y<24) 
h 52 specify horizontal and vertical sizes of area 
Ra (xth<32, ytv<24) 








specifies ink colour | (0<=c<=7) 
specifies bright (1 一 bright 0=off) 
+ || specifies flash (1—flash, O—off) 


7050 LET ь-егзае: 

zz0: RESTORE 7960 
7051 FOR i=@ TO 1-1 
7@52 POKE 
7053 NEXT i 
7054 LET z-INT 


7955 READ а: 
#27"; STOP 





























LET t=130: 


READ a 
LET z=z+a 


LET 
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МҸ 
№ 

De 

өл 


2.22. NOP 
у 


0009000. ~ 
N- NENNO- 
ONON- OOM в 
блато: 0 


№ 
8 
N 


8- шобышыллу 
900: 090995 
У PON ~ P> ч 
fe POMS fos 
REIN RO 

ІНІ 


к) 
5 
0 
N 
с 
2 
3 
D 
атаошыав Рова 
орлоно небо 
G- gene. > 0- 
> №- ОФ 
S- Q- пеш 
Ns sss 
- едвам 
ADANTA 


-ө 




















SCREEN COLOURS 2 





The Spectrum PAPER command sets the background 
colour of the whole screen. The window paper routine 
on this page, ЕХс, allows you to set the paper colour of 
only a part of the screen, in the same way that you can 
use the window ink routine to change the INK colours 
on a part of the screen. 

As for the ink routine, the paper routine requires you 
to specify the top left-hand co-ordinates and height and 
width of a rectangular area within which the colour is to 
be changed. Unlike the PAPER command in BASIC, 
you will see any colour change without having to clear 
the screen with CLS. Again, like the previous routine, 
you сап use the routine to set the BRIGHT and FLASH 
attributes of the area. By calling the routine several 
times you can create a layered effect, with colours 
apparently superimposed on one another. 

A layered effect forms the basis of the random boxes 
program on this page. Random values are chosen for the 


RANDOM BOXES PROGRAM 





EF FN СОК М,Румус,Ь, го «ыза 


5 
22 пггггглабо 


пебевевнвена 
OD- полковете. 
9596956566095 














start co-ordinates (x1,y1) and horizontal and vertical 
increments (h1,v1) of the area, and a random colour 
value is chosen, before the routine is called, inside a 
loop. Note that the machine-code routineis called using 
RESTORE rather than RANDOMIZE. Using RAND- 
OMIZE would reset the seed of the random number 
generator within the loop, so that the same random 
number sequence would begin again and again. 


“MONDRIAN” PAINTING Line 10 defines the window 


PROGRAM paper routine, 
Lines 100-150 draw the black 

nn: ара 

08:01 secona lines”. 


Lines 160-190 draw the 
How the program works coloured areas. 
The window paper routine Line 190 also stops the. 
draws black “lines” (single program continuing until a kcy 
character-width boxes), is pressed, so that the bottom 
then fills areas of the screen two lines of the display are not 


with colour. lost. 










































































































































































































































































































































































































































































The “Mondrian” painting program demonstrates 
how by using only a single routine, you can produce 
quite an effective display. 

“MONDRIAN” PAINTING PROGRAM 
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Start address 62600 Length 150 bytes 
What it does Changes the PAPER colour of a specified 
rectangular area of the screen. 


Using the routine The routine works in the same way as the 
window ink routine, except that here the PAPER attributes are 
changed within the area specified. As before, it could be 
dangerous to go beyond the limits set for the parameters, so 
the sum of x and h should always be less than 32, and y and v 
together should be less than 24. This is because h and v are 
relative, not absolute, parameters, which means they are added 
to x and y respectively to produce the values actually plotted. 
Thus, if xis 15 and his 20, then the right-hand edge of the paper 
area is column 35, which is off the screen. 

As before, the routine operates over the whole Spectrum 
| 32x24 character screen, not just over the normal 32x22 
graphics area. 








E PARAMETI 
DEF FNe(x,y,h,v,c,b,f) Е 
specify top left-handcorner of box агеа(х <32, y<24) 

















specify bottom right-hand corner of area (x+h<32, 
ytv<24) 














БАЙ | specifies paper colour осел) 





b specifies bright (1=bright, O=off) 




















+ specifies flash (1—flash, 0--оН) 
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STOP 
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ENLARGED TEXT 





Doubling the size of Spectrum characters is quite 
straightforward in principle. Spectrum characters are 
drawn on a grid eight pixels by eight; they can be 
enlarged onto a 16x16 grid by the routine looking at 
each pixel of the 8x8 grid in turn. If a pixel is filled, then 
two pixels across and two pixels down are filled on the 
16x16 grid. The diagram below gives an example of a 
character and its enlarged version. 





HOW A CHARACTER IS ENLARGED 









8x8 grid 16x16 grid 








Both routines use this method to enlarge a string of 
characters (text or graphics) and then print them on the 
screen at twice their normal size. The horizontal text 
routine, FNd, prints enlarged characters across the 
screen; the vertical text routine, FNe, prints the 
enlarged characters downwards. 

The two demonstration programs below show how 
the routines are used. Both programs begin by defining 
the word “Spectrum” as the string (n$) to be enlarged by 
the routine, and both then POKE these characters into 
memory using a subroutine beginning at line 500, The 
string must always end with 13, the code for 
RETURN, to signal to the computer there are no more 
characters to be enlarged. The horizontal text program 
prints the string against a background of horizontal 
lines; the second program displays the vertical string six 
times, each time with a different coloured background, 
using the window paper routine. 

















DEF FN ie USR 62200 
BORDER 1: PAPER 6: INK i: с 
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FOR ise то 
Бабы 28-72. Свен 0,6 
DRAW -255,ө: DRRU 6,6 
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‘OR TO 22 STEP 4 
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VERTICAL TEXT PROGRAM 









12 DEF FN c(x,y,h,V, C, b, f) -USR 
62500 


20 DEF FN е (x,y) =USR 61990 
100. BORDER 1. PAPER O: INK а 


ГЕ 
iia LET n$-"Spectrum" 
15а GO зив ваз 

130 LET ciei 

то 25 STEP 4 


FOR x55 
RBNOOnIZE FN ctx-1,2,4,19,c 


Reuoonrze „ДМ eom 
LET CLSC 
xT 
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Start address 62200 Length 220 bytes 
What it does Displays a double-sized version of specified 
characters horizontally on the screen, 


Using the routine Before using this routine, you must first use 
some BASIC lines to store in memory the text (n$) which you 
want to display, Lines 500-560 of the programs on the facing 
page provide an example. 

The text is stored as a string in 100 bytes of memory from 
address 62500 to 62600. The routine continues printing 
characters from this location onwards until it reaches a 
RETURN message. 

Note that with double-sized characters you are now restricted 
to 16 characters across the screen; longer strings are 
continued on the line below. To print a space in the text string, 
use the graphics blank character (above the 8 key) rather than 
the space key. 
[ 
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Start address 61900 Length 215 bytes 
What it does Displays a double-sized version of specified 
characters vertically on the screen. 


Using the routine This routine works in the same way as the 
horizontal text routine, but prints text down the screen instead 
of across it. The same BASIC subroutine is needed to store the 
text string (lines 500-560 of the demonstration programs on 
the facing page). Remember to put the string into memory 
before calling the routine. 

Since each character is twice its normal size, only 12 characters 
down are shown in a column. The routine displays only one 
vertical line of text, and does not continue a message across to 
the next column. To display a message longer than 12 
characters, call the routine again for each new column of text. 
To obtain a space in the text use the graphics blank character 
(above key 8). 











DEFFNd(xy) - a] 





specify position on screen from which text is to be 
printed (х<<32, у< 24) 


[=] 











LET b-62200 t s215: 
RESTORE 7160 

FOR і-0 TO 1-1: READ a 
POKE (b+i),a: LET 2-7г +а 
NEXT 


i 
СЕТ z=INT 


LET LET 


сегіз - INT (zz) 
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READ а: IF a<>z THEN PRINT 
STOP 
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DEF FNe(x,y) 
X specify position on screen from which text is to be 
printed (х< 32, y 24) 

7259 LET b-619500 LET 1-210: LET 
zz RESTORE 72 
7251 OR з-е ТО t-f: READ а 
7252 POKE (Ь+1) ‚а: LET ?«гта 
7253 NEXT 2 
7254 LET zzINT (((z7/1)-INT (2/00 
жі) 
7255 READ а IF a«»z THEN PRINT 
29%; STOP 
7260 DATA 42,11,92,1,4 
7261 DATA ©,9,56,1,8 
7262 DATA @,9,94,237,83 
7263 DATA 191,242,62,99, 71 
7264 DATA 33,36,244,34,195 
7265 DATA 242,197,257,91,191 
7266 DATA 242,62,30,186,242 
7267 DATA 244,241,195,62,242 
7268 DATA 62,200,167 ,250,62 
7569 DATA 242,42,195,242,126 
7270 DATA 35,34,195,242,254 
7271 DATA 31,250,62,242,254 
7272 DATA 144,242,62,242,214 
7273 DATA 32,1,5,0,42 
7274 DATA 54,92,36,9,61 
7575 DATA 32,252,34,193,242 
7276 DATA 123,239@,24,246,64 
7277 CATA 193,123,230,7,183 
7978 DATA 31,531,31,31,150 
7979 DATA 111,34,169,242,205 
7280 DATA 64,242,58,191,242 
7281 DATA 60,50,50,191,242 
7585 DATA 193,16,169,201,193 
7283 DATA 201,17,157,242,6 
7284 DATA 32,62,0,16,19 
7585 DATA 16,252,237,91,193 
7286 DATA 242,33,157, 242,6 
7287 DATA 8,197,26,1,2 
7288 DATA 4,197,23,245,203 
7289 DATA 22,241,203,22,16 
7290 оята 247,35,193,13,32 
7991 DATA 241.43,126,245,43 
7292 DATA 126,35,35,119,35 
7293 DATA 241,119,35,19,193 
7294 DATA 16,228,42,189;242 
7295 DATA 17,157,242,14.2 
7296 DATA 229,6,8,26,113 
2297 DATA 35,19,26,119,13 
7298 DATA 43,36,16,245,225 
7299 DATA 62,32.133,111,48 
7300 DATA 4,62,8,132, 103 
7301 DATA 13,32,226,201,0 
7302 DATA 125,0,0,0,0 
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PICTURES WITH POINTS 1 








The Spectrum ROM routine which is called by the 
BASIC command PLOT to draw single points is also 
used by the BASIC DRAW and CIRCLE commands. 

The point plot routine given here, FNg, is used in the 
same way, both to plot points on the screen, and to 
provide the basis for the other drawing routines in this 


COSINE CURVES PROGRAM 





f(x.u)-USR 61500 
PAPER O. INK 2 


FOR je248 TO 160 STEP -4 
FO 1 To 5180 
(98 +ве + (соз 


я 
ЕТ Y=ZNT 


съжРт 


RANDOMIZE FN 
NEXT m 
3 


в том) 





book, including routines for lines, boxes and circles. 

The demonstration programs on this page may seem | 
slower than you would expect. This is not due to the 
speed of the routine, but because the BASIC program is | 
switching to machine code for each single point and then | 
returning to BASIC. Later drawing routines, which call 
the point-plot routine from machine code, give a better 
indication of the routine’s true speed. The programs 
here show only the difference in speed between the 
BASIC commands RANDOMIZE and PLOT. 

The planet program plots random points on 
horizontal lines which begin and end on the | 
circumference of a circle. There is an increasing 
probability of a point being plotted towards the right of 
each line (line 540). The series of exponent curves are 
produced by varying the horizontal co-ordinate, x. 


COSINE CURVES 
PROGRAM 


12:30 minutes 


How the program works 
Over 10,000 points are plotted 
in a series of cosine waves. 


Line 10 defines the function. 
Line 130 sets the horizontal 
start co-ordinate of each curve. 
Line 140 calculates the y 
co-ordinate (each curve is a 
slightly different function, 
since j varies for each curve). 
Line 150 plots a point at m,y. 









































PLANET PROGRAM 


10 DEF FN 
да BORDER в 


110 LET с-во 


1 





Line 130 raises x to the power n to determine the point 
for plotting, z. Line 160 plots the curve again, 
subtracting co-ordinates from an initial value. 








FNf 


Start address 61500 Length 65 bytes 


What it does Plots a single point on the screen. 


Using the routine The point-plot routine uses pixel rather 
than character co-ordinates. Pixel co-ordinates are calculated 
from the bottom left-hand corner of the screen, unlike charac- 
ter co-ordinates which start on the Spectrum from the top left- 
hand corner. Thus, points are calculated on the screen from 0 
to 175 vertically upwards, and from 0 to 255 horizontally: 
point (255,175) is the top right-hand corner of the screen, for 
example. Note that routines in this book which use pixel points 
will not go over the text area of the screen (the bottom two 
lines of the screen) since the point (0,0) is actually above 
these two lines. 






R OUTINE P 
__РЕЕ ҒМҚх,у) 


Cify pixel position at which point is to be plotted 
256, y<176) 
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EXPONENT CURVES PROGRAM 








DEF EM fix 
BORDER 6 


FOR n-i.i9 то 














EXPONENT CURVES DISPLAY. 
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PICTURES WITH POINTS 2 





The displays on the previous page used only a simple 
BASIC listing and a single routine, the point-plot 
routine, There is no reason why you should not combine 
routines together to produce far more complex displays, 
as demonstrated here. 





The cityscape program 

The large display on this page is produced by a single 
program, the cityscape program. The program 
combines plotted points with three other routines to 
produce the display. 

A total of four routines is used in this program. The 
skyscrapers are drawn by the window paper routine, 
FNb; the vertical text routine (FNe) is used to draw the 
word SINCLAIR, printed in blue by the window ink 
routine, 

The effect of a crowded group of skyscrapers is 
achieved by drawing coloured windows at random. The 
effect of random heights but a constant base line is 
achieved by making all the windows end on the bottom 
line of the screen. This is done by subtracting the start y 
co-ordinate (y1) from 25, the total number of vertical 
text characters on the screen plus one. 

The vertical text routine, which is used to print the 
word “SINCLAIR”, must have the letters which are to 
be displayed placed in memory before the routine is 
called. Lines 110-170 take the characters from the word 
one at atime and POKE them into memory ready to be 
used by the routine, As before, the final character 
entered is 13, the ASCII code for carriage return. You 
will remember that the routine requires the co-ordinates 
of the top left-hand character (x,y) as well as the stored 
text string in order to print the text. The window ink 
routine is used in line 360 to give a blue colour to the area 
over which the text is to be printed. 








bis, Us bv, €, b, f) sUSR 


ех. поза 62900 
а E, Е) =USR 


use 61520 


NEXT i 
RANDOMIZE FN © 


,8.8) 
240 FOR i 


-і To se 


scrort? 








Line 210 calls the point-plot routine to plot the stars. 
Random co-ordinates are chosen in lines 190 and 200 
for each star. The moon is drawn in lines 530-560 by 
using semicircles nested inside each other, using the 
Spectrum BASIC DRAW command. A later routine in 
this book will enable you to produce circles using 
machine code. Finally, the meteor is drawn as a series of 
straight lines (lines 490-510), again using BASIC. 

You will notice from the listing for this program that a 
convention has been used for all the listings in this book. 
Lines numbered from 10 to 90 are used for the function 
definitions, while lines 100 onwards are used for the 
main listing. You can thus see clearly which machine- 
code routines have been used for each program, as they 
are placed at the beginning of the listing. 












































CITYSCAPE PROGRAM CONTD. CITYSCAPE PROGRAM CONTD. 


RANDOMIZE FN c(4,i,1,1,6,1, 


NEXT i 
RANDOMIZE FM 


RANDOMIZE с(16,9,1,15,4, 
RANDOMIZE FN c(17,6,2,18,4, 
RANDOMIZE €(19,10,1,14,4 
RANDOMIZE 5b(17,5,2,15,1, 


EN е(17,6) 
FN cti1jíl,s,14,2, 


то за STEP 
се, , 2, Le , 








5 CITYSCAPE PROGRAM 


00:15 seconds 


This program calls four 
routines, all of which must be 
present in memory before 
RUNning the program: 


RAD 
人 





window ink routine (FNb) 
page 11 

window paper routine (FNe) 
page 13 

enlarged vertical text routine 
FNe) page 15 

point-plot routine (ЕМГ, 
page 17 








How the program works 
Lines 10-40 define the 
routines. 

Line 110 defines the text 
string. 

Line 120 sets up a loop to 
POKE characters into 
memory. 

Line 130 POKEs a single 
character into memory. 

Line 170 POKEs ASCII code 
13 into memory. 

Lines 180-220 print stars at 
random points in the top 74 
pixel rows of the screen. 

Lines 240-320 set up values 
for the window paper boxes 
and draw them — a total of 50 
boxes. 

Lines 330-380 draw the 
"buildings? with windows 
which appear in front of the 
paper boxes (lines 340 and 360 
print flashing boxes). 

Lines 480-510 draw the 
comet. 

Lines 520-570 draw the | 
moon (a series of sem | 
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LINE GRAPHICS 1 





Lines are drawn in BASIC on the Spectrum using the 
command DRAW. This command uses relative co- 
ordinates, that is, the command is followed by co- 
ordinates which specify the distance from the current 
plot position, A line is then drawn from this point to the 
specified point. Itisn’t always as simple as it may seem to 
calculate this horizontal and vertical increment from 
the current plot position. 


The line-draw routine 
The routine on this page, FNg, offers an alternative to 
Spectrum DRAW for drawing straight lines. This 
routine is faster than the DRAW command, and uses 
absolute, rather than relative co-ordinates. Thus, you 
no longer have to worry about calculating distances 
from the current plot position. 

The line-draw routine contains some error-trapping 
to prevent the Spectrum crashing if the routine is called 


CUBE PROGRAM 
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SUNSET PROGRAM 


10 DEF FN cix, yh, V, C, b, f) SUSR 
га 
20 DEF ЕМ 3 9 раз тозн ©2700 


BORDER ё: 


11e RANDOMIZE FN 5(0,0,38,17,#, 


$9.79 174 STEP 22 
gto, 4,128,40) 
FN 31858: 37348740 


255 STEP 


Зе то 1а 
RENDOMIZE FA 9 (J. 175,126,40 


NEXT j 

FOR j=36 TO e ST 
$ RANDOMIZE FM oT ка S) uU, f 
КЕЙТ 
9 NEXT j 












































with off-screen co-ordinates. This makes it easier to 
devise complex graphics displays using a trial and error 
method, since there is less danger of losing both 
program and routine if off-screen co-ordinates are 
entered, 

The cube display on page 20 is formed from a series of 
lines. The program is very simple. The line draw routine 
draws four lines repeatedly in the loop from lines 120 to 
170: two to draw the grid pattern, and two for the pers- 
pective effect. Lines 180 and 190 specify the two lines 
which complete the cube shape. 


SUNSET PROGRAM Line 110 sets the blue colour 


in the bottom part of the screen 


80:03 scconas 


How the program works 
Yellow lines are drawn 
radiating from a point at the 
centre of the screen to points on 
the edge. Horizontal lines are 
then added to create a reflec 
tion effect. 


using the window paper 
routine, 

Lines 130 and 140 draw the 
horizon, 

Lines 160-180 draw the 
yellow lines in the sky 

Lines 190-210 draw the 
horizontal lines on the lower 
half of the screen. 
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LINE-DRAW ROUTINE 








Start address 60700 Length 205 bytes — 
What it does Draws a line between two specified points. 


Using the routine This routine draws a line joining any two 
pixel points on the screen. Although the Spectrum already has a 
line draw routine available in BASIC, the version given here is 
much faster, and uses absolute rather than relative co- 
ordinates. Ths means that co-ordinates p,q represent the 
position of the end point of the line, not the horizontal and 
vertical increment from x,y. 

The routine will usually work if off-screen points are specified, 
but for safety some error-trapping has been incorporated. If you 
attempt to plot lines off the screen, you will see an “Integer out 
of range’ message, unless the value you have entered is more 
than 255 pixels off the screen; in this case the routine will 
probably crash. 






































| ROUTINE PARAMETERS 
DEF FNg(x ) 
| ху specify start position of line (х<<256,у<<176) 
Pq [specify end position of line (p<256,q<176) 
ROUTINE LISTING 
7400 LET b-60700: LET '-210: LET 
zz0: RESTORE 7410 
7401 FOR i=@ TO 1-1 RERO a 
7402 POKE (b+id,a: LET z-z^*a 
27403 EXT i 
Arion LET Z=INT (((z^7/l)-INT (174) 
* 
7405 READ а: IF a«»z, THEN PRINT 
TT": ТЕ 
2419 DATA 42,11,92,1,4 
7411 DATA 0,9,56,14,6 
2412 DATA 9,94,237,83,26 
2413 DATA 237,205,226;237,94. 
7414 DATA 42,26,237,217,229 
7415 ATA 217,237,115,175,237 
7416 DATA 1,1,1,122,148 
7417 DATA 210/76,237,6,255 
2418 DATA 257;68,87,1іг23,14е 
7419 DATA 210,80,237,14,255 
7420 DATA 237,68,95, 122,187 
7421 ATA 48,10,106,237,.,67 
7425 DATA 177.237.175,71,195 
7423 DATA 107,237,178,202,167 
£424 бата 237,187,90,537,67 
7425 DATA 177,237,14,0,9 
7426 DATA 123,31,133,218,118 
7427 ATA 237,185,215,120,237 
7428 DODATA 148,87,217,237,91 
9429 бата 177:237,195,132,237 
7430 DATA 87,197,217,209,42 
7431 DATA 26,237,123,133,95 
7432 бата 122,68,132,218,164 
7433 DATA 237,202,167,237,01 
7434 DATA 87,237,33,26,23? 
7435 DAT! 205,179,237 ,217,122 
7436 DATA 29,32,205,195,167 
7437 DATA 237,202,147,237,237 
7436 ATA 123,175,237,217,225 
7439 DATA 217,201,161,214,1 
7448 DAT! 1,62,175,147,218 
7441 САТА 249,36,95,167,31 
7442 DATA 55,51,157,31,171 
7443 DATA 230,245,171,102,122 
7444 DATA 7,7,7,171,230 
7445 DATA 199,171,7,7,111 
7446 DAT 122,230,7,71,4 
7447 DATA 62,254,15,16,253 
тааз DATA 6,255,155,71,126 
7449 DAT 176,119,201,229,197 
7450 DATA 205,179,237,193,225 
7451 DATA 9,56,9,201,0 
7452 DATA 192,0,0,0,0 
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LINE GRAPHICS 2 


Line-drawing routines are ideal for producing 
interference patterns. These are produced when a series 
of lines or points are drawn so close together that what is 
produced is neither separate lines nor a complete solid, | 
but a pattern. 

The pyramid program below shows interference 
patterns at work. Each pyramid is drawn by a 
subroutine beginning at line 500, which draws lines 
from the top of the pyramid (the fixed point tx,ty) to 
points along a horizontal base line (by). Only the base 
x co-ordinate (x) is varied within the loop. Interference 
patterns are seen from near the top of the pyramid 
(where the lines no longer have the appearance of a solid 
figure) to a point towards the base of the p yramid 
(where lines are beginning to be seen distinctly 

The line pattern program demonstrates a related 
phenomenon. Here the line-draw routine (called in lines 
140-170) has the paradoxical effect of producing 














LINE PATTERN PROGRAM 








8 FOR 32 
„128 RANDOMIZE 
“ізге RANDOMIZE 


189 RANDOMIZE 


52-2) 
7172 RANDOMIZE 


200 NEXT 





PYRAMID PROGRAM 


10 DEF FN b(x,u,h,v,€, b, f) возя 

62500 

За Век ғы cx, Yh, v Cb, Г) =USR 
rrj 


555 
Зе DEF FN 1 <озв 69700 
NK 2 


Во ВЕ иа 
BORDER PAPER 1: T 
@ ELS 
RANDOMIZE FN с10,8,31,14,6, 
LET 


> LET by=60 


г LET ь=182 
Go Зив 520 
в zza TO b 


LINE PATTER} 








DISPLAYS. 
































































LINE INTERFERENCE PROGRAM 


curves. The series of horizontal and vertical lines in 
sequence produces the curve effect. As the lines become 
closer together, with each successive display, a better 
effect is obtained. 

The line interference program shows how a program 
similar to the line pattern program can produce 
interference patterns simply by increasing the number 
of lines plotted on the screen, from 150 to 255 (the 
variable i in line 130). 

















| 





LINE INTERFERENCE 


LINE INTERFERENCE DISPLAY ] 








PROGRAM 


00:06 seconds 


How the program works 
Patterns are produced by 
drawing lines from cach corner 
of the screen to the opposite 
screen edge 

Line 120 sets up the first loop, 





to draw complete displays, 
Line 130 sets up the second, 
inner loop, which calls the 
routines 255 times to draw a 
single display 

Lines 140-170 call the line 
routine to draw four lines, 
Line 190 waits for a key to be 


pressed before clearing the 
screen and beginning the next 
display. 

















TRIANGLES Е 


А triangle shape is useful as the basis of all kinds of REPEATED TRIANGLES PROGRAM 
graphics displays. Pyramids, mountains, trees and 
bushes can all be formed from a triangular shape; even 











the spotlight display on this page is drawn with 10 ОЕР FN i(x,U,P,q4,r,S) -USR в 
triangles. However, Spectrum BASIC does not have a BORDER в- PAPER 6: INK 2: с 
single-statement triangle command. “Zao LET с=63: LET xc-i27- LET y 
The triangle routine, FNi, enables you to draw FOR ic? то 2 STEP -1 | 
triangles quickly and painlessly. Like the line-draw 12% RHNDOHIZE FN iiKC-BXU,uC-u, 
тои aie re > 5 Е хе бест XC, gC-U) 
routine (Е Ме), on which it is based, the triangle routine 156 NEXT а 


à Е я 1ва pause e. сіз 
uses absolute rather than relative co-ordinates; this 178 NEXT i 
makes complex graphics displays easier to program. 
AII the displays shown here make use of the routine 
within a loop or loops. The repeated triangles program 
is based on triangles plotted between two parallel lines. 
Several interesting modifications are possible here: try, 
for example, changing the first x co-cordinate of the 
triangle from xc-2«y to хс-у. This will produce 
parallelograms between the parallel screen edges. 
The spotlight display is produced by drawing a series REPEATED TRIANGLES 





along a straight line, by 








of triangles from a single point (5,170). The base ofeach PROGRAM changing the variable y for 

triangle is a horizontal line, the end points of which lie cach successive triangle. 

on the circumference of a shallow ellipse. 00:0 Эесовав Line 120 begins the first loop, 

The final program, the triangle curves program, is a oed t wae eee ie pne 

display of curves produced from sequences of triangles. | тру roe program works . почест each triangle in His 

Th Жезде УВЕРЕНЫ he program draws a series of display 

The outer and inner curves are pro уш Ines triangles. Each of the three Line 130 sets up the second 

called in lines 130-140 and 180-190 respectively. | points of the triangle is moved loop, which draws the pattern. 
Ден ji m EIN 


cate 
AMT 


























SPOTLIGHT PROGRAM 


DEF FM itx, Y Par 
BORDER о: PAPER ә 
LET s=4 











FNi 

















TRIANGLE DRAW ROUTINE 





Start address 60300 Length 80 bytes 

Other routines called Line draw routine (FNg). 

What it does Draws a triangle given the pixel co-ordinates of 
three points. 


Using the routine The routine uses absolute co-ordinates. 
Specifying off-screen co-ordinates produces an error 
message; values more than 255 pixels off the screen will 
probably cause the Spectrum to crash. Colours are set by the 
current screen INK attributes. 


ROUTINE PARAMETERS 
DEF FNi(x,y,p,q,rs) 
х,у | specify first corner of triangle (x<256,y<176) 


ра | specify second corner of triangle (p<256,q<176) | 




















area to red using the window ink routine, 





Line 160 of the curves program sets the central screen 
Vb (which 
must be present in memory for the program to RUN). 





r,s | specify third corner of triangle (г<<256,5<<176) 











ROUTINE LISTING 





7600 LET b-60300. LET і-?5: LET 
228: RESTORE 7610 
7601 FOR Ө T9 5-1; READ а 

ET z-z*a 


2595 POKE 
NEXT 

7604 LET z-INT 

7605 READ а: IF a«»z 
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TRIANGLE CURVES PROGRAM 





bix 
зоа 
DEF FN i x,u,P 
QORDER + 





FOR aso то 
RANDOMIZE 
RRNEOMIZE FN. 


RANDOM 
55,173 




















CIRCLES AND ARCS 1 





Two methods are commonly used to draw circles on a 
computer. The first uses a combination of sines and 
cosines; this is the method used to draw circles in 
Spectrum BASIC. The sine/ cosine method is derived 
from the fact that, for a right-angled triangle, the length 
of the horizontal and vertical sides can be calculated 
from the size of one angle and the length of the third 
side. If a right-angled triangle is formed between the 
centre of a circle and any point on the circumference, as 
shown in the diagram below, then the length of the sides 
is given by 





x =r х cos (a) 

y=r sin (а) 

You can see a typical example of circles plotted in 
Spectrum BASIC in the circle program on this page. 
The command requires the centre-point and radius to 
be specified (x,y and r). 





BASIC CIRC. 





55 PROGRAM 


тык 








DRAWING A CIRCLE USING SIN AND COS. 











X-rxcosa 
у- гезща 





The second method is faster in operation but requires 
more memory to implement. This method, based on 
squares, forms the basis of the machine-code routine 
It is derived from the equation 





This, of course, is Pythagoras’ theorem, which gives the 
relation between the sides of a right-angled triangle, as 
shown in the squares method diagram below. 





This method is more complicated than the sine 
cosine method, since it must calculate square root 
values each time a circle is drawn. To use it most 
effectively, first calculate a list of square roots and then 
store this list in memory — as done by the routine at 
address 59600. The list of square roots can then be 








_ DRAWING A CIRCLE USING SQUARES 


“consulted” by the main routine. Using stored square 





RR 


ИМ 


| 
CL 





Xaxtyeyarer 
y=SQR(rer—x*x) 


roots makes this routine much faster — and more 
accurate — than using the BASIC CIRCLE command. 


Using the routines 

Together with the BASIC square loader program, the 
routines given here do the work of calculating points for 
circles to be drawn. After keying in these routines you 
will not yet be able to produce anything on the screen, 
because the routines do not in themselves draw any 
curves; for this you must also key in one of the curve 
routines in the following pages. 
























































29 
7720 оята 50,115,222,50.1214 
7721 DATA 232,205,120,252,50 
7725 DATA 116;232;71;58,115 
7723 DATA 232,144,200,58,115 
dd 2225 BATA 128.294.71: 58.121 
Start addresses 59600 and 59000 | 2726 DATA 252,124,92,34, 50 
Length 60 and 525 bytes | 2282 DATA 55,123,252, 56 121 
2 oy " | я 232, 31,48, 
Other routines called Point-plot routine (ЕМ) 2288 BATA 58,116,232, 58, 124 
What they do Carry out the calculations for the arc, sector and эәне GHA FOX TUN га SSL. Se 
Ы | Е 42 Е 
segment routines. 7731 Бата 116;532;71,58,119 
A " 7732 DATA 232:144,50,124 „232 
Using the routines The following BASIC-program must be 2233 DATA 1922243:58 220 222 
keyed in and RUN before using the machine-code routines given 7735 DATA 230/1,32,8,55 
here: 7736 DATA 0,50,124,2252,195 
: 2152 Бата E о 
10 LET j= 59700 $239 DATA 832,71,33,105,231 
20 FOR i= 070255 7740 DAT 16,0 5,16 
icd а 17,19,0,25, 
30 LETp — i i: LETh = INT (p/ 256) 2241 DATA 255,24. i25 232 96 
Р Di 932, 21,42 
40 LET |= p—256 * h 2249 DATA 91.58,122,232,52., 
476 4- 122,232, n B 
50 POKE 1: РОКЕ j +1,h 7749 DATA 42,125,232,233,205 
60 LETj =j+2 7746 DATA 81 ,232,58,122,2з2 
7747 DATA 33,124,252,190,40 
70 NEXT i 7748 DATA 43,60,250,95,231 
| 7749 DATA 24,228,58,122,232 
This program POKEs the squares of numbers from 0 to 255 into | 7758 DATA 71,58,119,292,167 
memory. Each square is stored in two bytes, since numbers #232 Бата НЕЕ 
larger than 16 squared will not fit into a single byte, which has a 7753 бата 233,205.81,232,58 
maximum value of 255. Having keyed in this routine, SAVE the (55 CATA tee soca Ri SEA m 
area of memory containing the squares by using the command z288 сета 3854314766780 БӘ. 
SAVE “title” CODE 59700,600. These 600 bytes аге also used 2258 Dara 232/52,0,56,135 
as workspace by the circle routines. 2758 CATE REQ BSEC quie. 
The routine at 59600 calculates square roots and stores them 7760 DATA 200,254.1,202,205 
in memory. The longer routine, starting at address 59000, cal- 22a: DETO ава; aes S TOU EE T 
l jO! he circul i 7263 DATA 111,232.1360,87,58 
cu lates p us on the circumference of a circle using these 7280 DATE 111 Ее DO TOT DOM 
square roots. 7765 DATA 43,431,95,56,122 
7766 DATA 232,87,58,111,232 
7767 DATA 130,87,58,110,222 
7766 DATA 131,95,195,80,231 
7769 DATA 95,$8,122,2532,87 
7659 LET 59600: LET t-55 LET 7779 DATA 58,111,232,146,87 
Z2@: RESTORE 7660 7771 DATA 58,110,232,131,95 
7651 FOR і=8 TO l-1: READ а 2225 бата 195,43,231,87,58 
2r Mie е er reta ELE UE RUBRIC 
7884 LET Z=INT (((zzU)-INT 《zt 2275 бата 233,191,95; 19$,50 
76S5-REQD s. IF а<о2 THEN PRINT 2225 BATA 551257111:2527126 
: ФТОР 2778 DATA 87.58,110,232,147 
RE деле nara edi 7779 DATA 95:195,45,251;55 
7661 DATA 18?,52,1,201,1 7780 DATA 58,122,232,87,53 
2888 BATA 10.103.192.237.82 2781 бата 111,532,146,87,58 
2664 DATA 242,234,232,3,24 Е АЕ че 
2665 бата 242:17.202,22:96 2283 BATA 80,225,22,294125- 
7666 DATA 125;55,124,157,31 sees ae J 
7667 DATA 125,31,201,33,52 2285 оята 299,87 932178255 
2886 DATA 253.225 2:48” 7786 DATA 147,95,195,43,231 
DATA 1 Sé, ss 25:84 7787 DATA а?,5з,)22,шсе es. 
$858 бета 1:282922172%2 7788 DATA 58,111,532,130,57 
282% Бата Зов. ев’ ” | 7789 DATA 58,119,232,147,95 
77906 DATA 195,38,231,6,5 
7791 DATA 203,53,16,252,6560 
7792 DATA z01,230,31,254,0 
7793 DATA 200,71.175,79,237 
припев 
7799 LET ЬЕЕ098: LET 1-520: LET 2288 Dara 32,1760; 16,247 
7701 кон i=0 TO 1-1: READ а 2792 DATA 920425344925 
2262 DORE tbri),à: LET zezea 7798 DATA 187,205,25,205,25 
3383 NEXT i ы 4 7799 DATA 203,26,203,27,16 
TOUS LET zzINT (((z7/Vl) -INT (2/4 таға para 25205. 208.232, ара 
пепо нЕ В ае шк ЭРА “ЕНЕМ BEER 7895 DATA 232,42;117,232,167 
Ed EST 
7710 DATA 62,1,50,104,232 8 Е à е 
7711 DATA 58:113,232,205,г46 нәз DOTA аза, азы oy e cc а 
7712 DATA 232,237,53,117,232 i 4 3537. 
7215 DATA 157,223;26,223;27 2885 Бата ВЕ 22 ва 
7714 DATA 205.295,232,50.;11o 2898 BATA Sei e096. 465" 
7715 DATA 232,52,113,232 205 7810 DATA 52,130.80,110, зе 
7716 DATA 11,232,58,158,232 7611 DATA 20,170,15,11,132 
7717 DATA 52,114,222,205,11 7815 DATA 3,21,7;6,0 “ 
7718 DATA 222,50.121,252.58 7813 DATA 1.10,213.231,0 
7719 DATA 113,252,205,19,252 | 7914 DATA 234,0,0,0,0 | 
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CIRCLES AND ARCS 2 





With the arc routine, FNj, given on this page, you will be 
able to draw arcs more quickly and with more flexibility 
than with the Spectrum DRAW command. The routine 
can be used to draw either arcs or complete circles by 
varying the final two parameters. 

To produce any circle-based program on this page, 
you must first key in the machine-code routines and the 
BASIC squares program on page 29, as well as the 
routine given on this page, since the arc routine calls all 
these routines. 


Starting and finishing the arc 

The only complication of the arc routine given here is in 
specifying how much of the circle is to be drawn. The 
start and finish parameters can have values from 0 to 
255, instead of 0 to 360, This is because the parameters 
are stored in a single byte in memory, and one byte can 
have only 256 values (thatis, from 0 to 255). This means 


ARC PATTERN PROGRAM 





іс DEF FN j(x,w,r,s, б) 


109 BORDER 1. PAPER 6. INK 2 

i хс=138: LET 
-4 

2 INT (y +2) 

Yee iNT 8,127?) 

Ó NEXT + 


that s,f values of 0,255 will draw a complete circle, 
values 0,127 will give a semicircle, and so on. 

Since the routine begins drawing from a position 
horizontally to the right of the selected centre point, 
s,f values of 0,64 will produce a quarter circle from the 
right of the centre to a point vertically above it. The 
diagram below shows how the start and finish 
parameters correspond to the more usual degrees. 








CALCULATING POINTSON A CIRCLE 





Using 
degrees 一 
и 
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oa 
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FNj 
ARC ROUTINE 














ROUTINE PARAMETERS 











[ DEF FNj(x,y,r,s.f) 
Start address 58900 Length 45 bytes xy || specify the centre point from which the arc is drawn 
Other routines called Master curve routines. i (х<<256,у<<176) 


What it does Draws an arc or circle at a specified radius from 
a centre point. 


Using the routine The table on the facing page shows how 
the s and f parameters specify the length of the arc. A dif- 
ference of 255 will produce a complete circle, 127 a semi- 
circle, and so on. The numbers themselves define the angle 
from the centre of the circle at which the arc starts and 
finishes. The arc is drawn from a position due east of the 
centre of the circle, so that an s or f value of 1 is to the right of 
the centre point, a value of 128 to the left, and a value of 192 














r specifies the radius of the arc ((<<256) 


























s,f ||specity the length of the агс(5<1, 5<<256/-<256) 
d ~ ROUTINE LISTING 
таза LET b-s5s0e. LET (-40 LET 
228? RESTORE во 


1-1: READ а 
„8: LET z-z*a 


(CUZ 70) -INT (2/40 

















directly beneath the centre of the circle. est а<>: THEN PRINT 
Unlike CIRCLE in Spectrum BASIC, you can draw curves with | 3 
this routine which go some distance off the top or bottom of the | 2862 Bara 522 за 
screen without an error message appearing. 2862 DATA 9.9 $4119, 
Berang of the way the r Een memory Warns, there аге | 7864 рата 232 E 113 
several screen positions where a curve cannot be drawn using z та 238 PIX. 
this routine. If you find the routine does not work in any position. 2865 Вата i28 В за за 
move the centre point one pixel in any direction 7868 DATA 17, 

| CONES PROGRAM 




















DEF FN 
BORDER о 
cts 


jx. rus 
PAPER à 


f)-USR 559 
INK е 


$ (254-1 #5, INT 


The cones program produces patterns by varying the 
x and y co-ordinates of the centre of a circle each time it 
is drawn. In the left- and right-hand patterns, the x co- 
ordinate is a function of the variable i, while the y co- 
ordinate is given by i raised to the power of 1.7. As a 
result, the circles appear on a curve. In the third loop, 
only the y co-ordinate is varied, so that the sequence of 
circles rises vertically. 








CONES PROGRAM 
51:11 
00 * 1 1 seconds 


How the program works 
Three cle patterns are 
drawn, using the circle routine 
within a loop. 


Lines 120-140 draw the left 
hand circles. 

Lines 150-170 repeat the 
above loop, reversing the x,y 
co-ordinates. 

Lines 180-200 draw the 


centre circles. 
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SECTORS AND SEGMENTS 





The two routines on this page are useful supplements to 
the circle routine introduced on pages 30-31. Sectors 
are constructed by drawing an arc and then joining the 
end points to the centre from which the arc is drawn. A 
segment differs from a sector in that the ends of a 
segment are joined to each other, rather than to a centre 
point. The advantage of the routine is that they enable 


you to join the ends of an arc together without having to 
work out the co-ordinates of those points. 

Both the sector and the segment routines call the 
master circle routine (page 29), the arc routine, FNj 
(page 31) and the line draw routine, FNn (page 21). 
This means that the sector and segment routines will not 
work unless these other routines are presentin memory. | 














10 DEF FN ktx,u,r,s,f)-USR ва 


Be BORDER ©: PAPER ©: INK 4 


110 LET с-во- LET 
та 


59 ron 











The sector program on this page creates the illusion of 
a third dimension by repeatedly drawing smaller and 
smaller sectors while at the same time moving the centre 
point upwards and to the right. Try varying iin line 120 
to see a different number of sectors displayed. 

The segment program repeats a pattern of segments 
(drawn froma single centre pointin lines 140-150) three 
times across the screen, The number of patterns can be 
increased by varying the step size of x in line 120. 


SECTOR PROGRAM 


drawn in one display. 
0 т.7 1 
1771 [seconds 


Line 130 sets up a loop to 
va used to calculate the 





centr 


How the program works A 
sector of a circle is drawn 
repeatedly with decreasing 
radius. 

Line 120 sets up a loop to 
vary i, the number of sectors 











point and the radius. 
Line 140 draws a single 
sector. 

Line 160 waits for a key to be 
pressed before drawing the 
display again. 























вести с |) палатаны 














FNk 
SECTOR ROUTINE 











FNI 
SEGMENT ROUTINE 














Start Address 58800 Length 45 bytes 

Other routines called Arc and line-draw routines (FNj, FNg). 
What it does Draws an arc of specified radius, and joins each 
end to the centre point. 


Using the routine The sector is drawn anti-clockwise from a 
point to the right of the centre. When the ends of the arc are 
joined to the centre, the result is a wedge shape if the difference 
between s and f is less than 127, or a cut pie shape if the differ- 
ence is greater than 128. Sectors plotted off the screen to left 
or right may reappear rather unpredictably elsewhere on the 
E So it is best to keep within the parameter limits given 
elow. 





ROUTINE PARAMETERS 
DEF FNk(x,y,r,s.f) 














xy specify the centre point from which the arc is to be 
ic drawn (х<<256,у<<176) 








t specifies the radius of the arc (r<256) 





$4 |[specity the length of the arc (<I, s<256, 1256) ] 














i LISTING 






7900 LE е LET 1:48 LET 
zzea RE зе 

7901 FO 1-1 READ a 
7902 го! a LET z=z+a 
7993 NEXT i 

7904 LET z=INT (((Zz^/1i) -INT (2/10 
J #4) 

7905 READ а IF а<>2 THEN PRINT 
“eg: ВТО 

7910 DATA 205,20,230,237,91 
7911 CATA 106,232,42,110,232 
7912 DATA 229,0,34,26,237 

7913 CATA 205,51,237,237,91 
7914 CATA 198,232 ,225,34,26 
7915 CATA 237,205,51,237,237 
7916 бата 91,110,232,205,72 
7917 CATA 246,201,0,0,0 

7918 DATA 55.0,0.0,0 





Start address 58700 Length 30 bytes 

Other routines called Arc and line-draw routines (FNj, FNg). 
What it does Draws an arc of specified radius from a centre 
point, and joins the ends together. 


Using the routine This routine works in the same way and 
with the same restrictions as the sector routine, except that in 
this case the ends of the arc are joined together, rather than to 
the centre. 

Notice that, like the previous routine, you may get problems 
trying to connect the ends of the arc together, if either of the 
end points (and especially if both of them) are off the screen. 
As before, segments plotted off the edge of the screen to left or 
right will have unpredictable results: they may reappear on the 
other side, or cause the Spectrum to crash. 

- 


| ROUTINE PARAMETERS 
DEF ЕМІ (х,у,г,$, 


ху specify the centre point from which the arc is to be 
"|| drawn (x<256,y<176) 


r | specifies the radius of the arc (г<<256) 




















2) 


sf |[specity the length of the arc (s<f, s<256, 1<256) 























ROUTINE LISTING 3 = 








7959 LET bese7ee, LET Laas: LET 


7951 FOR і-Ө TO 1-1: READ a 
2852 POKE (b+i),a: LET zez*a 


XT d 
7954 LET z-INT (((Zz^l)-INT «ало 
7955 READ a. IF a<>z THEN PRINT 
"за" STOP 




















DEF FM iG gri в, F) SUSR 
BORDER 4: PAPER 4: INK 1 


4-92 

iz5 STEP 45 

FOR а то Ва STEP 10 
RANDONTZE FN L(x.4,i,125,19 


RANDOMIZE FN Lix,u,1,9,93) 
NEXT i 
NEXT x 























E" 


FILLING SHAPES 1 





The fill routine given here, FNm, enables you to fill any 
enclosed shape no matter how irregular. The routine 
works by looking at the pixels adjacent to the specifed 
start point. If a pixel INK attribute is set, the routine 
does not change it, and does not look at pixels adjacent 
to this one; otherwise, the routine sets the INK attribute 
to the current INK colour and moves to the next 
adjacent pixels. 

This method is known as the flood or grass-fire 
method, since, as you can see from its characteristic 
diamond shape, the INK spreads outwards until it 
reaches a “trench”, which stops it from spreading 
further, Any shape which is not completely enclosed, 
even if only by a single pixel, will “leak” when filled. 


Colouring irregular shapes 
Since the Spectrum can only have one INK and one 
PAPER colour in each character block, you may have 


FILL PROGRAM 





го: LET ча2=го 
f ix1,91,x2,u2) 


пррууевенеевенйе. 
699556666856859 555 


RANDOMIZE FN 上 
RANDOM FN f 


ON вореошачойвове SWE 


99 


PAUSE 10а 
RANCOMTZE 


ор 


а (10,53 


@-2 


problems when there are more than two colours on the 
screen, and you call the routine to fill irregular shapes. 
If, for example, the shape has diagonal edges, you will 
see a jagged effect corresponding to character borders, 
instead of a straight line when the shape is filled. The 
diagram below shows how a combination of INK and 
PAPER colours can be used to overcome this problem. 





FILLING SHAPES AT CHARACTER BORDERS 
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____ ee) нииеииазиасненииинииниий 
BOX FILL PROGRAM FN m 


FILL ROUTINE 


Start address 57700 Length 195 bytes 

Other routines called Line-draw routine (FNg). 

What it does Fills in an area bounded by a solid line of INK, in 
the current INK colour. 














Using the routine This routine fills in an area up to the edge 
of any shape enclosed by an INK line, or to the screen border. 
Remember that if there is even a single pixel of PAPER colour 
at the border, then the INK with which you are filling will leak 
out, and you may fill the entire screen. Notice also that a 
“wraparound” effect occurs when filling to left and right of the 
screen, which means that when the routine reaches the left- 
hand edge of the screen, it starts filling from the right-hand 
edge inwards, and the same will happen when the routine 
reaches the right-hand screen edge. 

If some of the attributes for character squares within the area 
to be filled differ from each other (as will happen, for example, if 
you change some of the attributes using the window ink routine) 
BOX FILL PROGRAM filled alternately. hen the area will be filled with these colours, rather than in а 


00: 05 Line 120 sets up а loop. single colour. 
seconds Line 140 fills a box if variable E — 
x is exactly divisible by 10 | ROUTINE PARAMETERS 


the value of DEF FNm(x,y) 


xy pixel co-ordinates of the point at which to start filling 
е: (к<256,у< 176) 




















How the program works 
Boxes are drawn іп а loop, and — x by 5. 





























ROUTINE LISTING 








8009 LET ь-577?00: LET \=199: LET 
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R ісаә TO 1-1. READ а 
8002 POKE (b+i) а: LET z-z*a 
$093 NEXT : 
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9995 READ a: IF а<>: THEN PRINT 
"92". STOP 
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8028 DATA 226,229,225,34,38 
8029 DATA 226,237,75,40,226 


зезе DATA 167,237,66,200,195 
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3 227,83, 
8035 DATA 226,52,175,147,216 
3033 DATA 95,157,31,55,31 
6034 DATA 157.21.171,250,249 
8035 DATA 121:103,122,7,7 
8036 DATA 7,171,250,199,171 
8037 DATA 7,7,111,122,230 
веза DATA 7,71,4,62,254 
8039 DATA 15,16,253,6,255 
| ағас DATA 158,71,126,160,192 
| 8941 DATA 125,176,115,42,40 
S042 DATA 226.237,91,á42,226 
| 8043 DATA 115,35,114,35,229 
6044 DATA 1,76,229,167 237 
89045 DATA 66,.92,5,225,3 
8046 DATA 44,226,229, 225,34 
заат DATA 40,526,2901,1553,19 
8048 DATA 57,0,0,0,0 
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FILLING SHAPES 2 





The fill routine really comes into its own when itis given SQUARES AND CIRCLES Line 120 sets a centre point 


highly irregular shapes to fill. Not only does it cope with PROGRAM for the display (x yl). 
these shapes with ease, it also fills them very quickly. пп:п9 Line 130 starts a loop to 
The two programs on this page give an idea of the Li Li* Э seconds draw the boxes and circles. 
moine iliti S Line 140 draws a box based 
outine's capabilities. | How the program works A on an increment from the 
The only complicated detail in each program is the | series of boxes and circles of centre point. 

calculation of the point from which the fill routine is to increasing size is drawn, and Line 150 draws a circle. 
start. Each program has to calculate this point on each the fill routine called inside Line 155 sets а test which 


pass of the loop. To ensure that whole numbers are areas at which the boxes and outine оп alter- 


passed to the routine, the formula for the co-ordinates of circles intersect of the loop only. 


ID н m Lines 10-30 define the 0-190 fill four 
the point is placed in brackets and an INT statement ЛЕ corners of the display. 
placed in front of it. 
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The squares and circles program fills in the inter- 
sections between a series of boxes and circles. The 
program is interesting for the different final displays 
which can be obtained by changing the values of a few 


parameters, caused by different shapes created each 
time the boxes and circles are drawn. The boxes and 
circles are drawn in a loop at lines 140-150, and the 
intersections filled at lines 160-190. 








SQUARES AND CIRCLES PROGRAM 


DEF FN 
DEF FN 


DEF ЕМ 
BORDER 
CET > 


„ча тнт 
ise RANDOMIZE Ем 
721 20,259) 


§(%2,92,INT ti 
са +8) 7328) 
as 


li +8) „за-тмт 


ae 


as 









The spiral program 

The spiral program is an effective use of the fill 
routine to colour in alternate portions of the circle. The 
two displays were achieved by varying n, which deter- 
mines the number of spirals to be drawn. 


SPIRAL PROGRAM the sequence repeated. The 


number of spirals is set by 


GO: 2B seconds variable n 
Lines 10-20 define the 
How the program works routines. 


Only the are and fill routines 
are used in this program. A 
circle is drawn and then two 
BASIC semicircles are drawn 
to join the centre point to the 
circumference. After two of 
these curves have been drawn, 
the space between is filled and 


Line 120 draws a complete 
circle (centre 128,88). 

Line 180 draws two curves in 
BASIC. using PI to specify 
semicircles. 

Line 190 fills the area 
between two curves on 
alternate passes of the loop. 





SPIRAL PROGRAM 


DEF FN 


а DEF FN mx ug) =05Я 
BORDER PAPER 1 


TOs 


31128,88,81,0, 
LET pd=24PIvn 
6 n 


(4045IN p) 





и 
SINT (BORC 
(604SIN (p-pd) 
p-pePd 
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_OVERPRINTING AND ERASING 





The OVER command in BASIC is one of four “logical 
operators” on the Spectrum; its more formal title is 
Exclusive/Or, or XOR for short. XOR forms the basis 
of the machine-code routine, FNn, on this page. You 
will recognize at once the other logical operators, since 
they occur in Spectrum BASIC with the same titles: 
AND, OR and NOT. Logical operators give a result 
depending on the way particular bits are set. The table 
below shows how the four operators make decisions. 








TABLE OF LOGICAL OPERATORS 











AND | OR NOT XOR 
AB AANDE|A B AORB|A NOTA|A B AXORB 
оо о loo o |o 1 бо o 
(БІ Жү ПЕ ТО Оов Jr т 
ТОО EURO 21 ede al 
Ш i e 1 и 0 














Thus, the XOR-line routine (FNn) looks at the screen 
before setting a pixel. If the pixel is currently set, the 
routine clears it; if the pixel is not set, however, the 
routine sets it. 








XOR ELLIPSE PROGRAM 


із DEF FM nix, 
за BORDER 5 


во то 110 


XOR ELLIPSE PROGRAM 


01:10 minutes 


How the program works 
Lines are drawn from a centre 


to points on an ellipse. 

Line 130 specifies how many 
lines are to be drawn. 

Lines 140-150 calculate the 
co-ordinates of a point on the 
circumference 









































INTERFERENCE CIRCLES PROGRAM 
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Юыныннрныннов 











The interference circles program shows how, Бу 
using XOR lines, two overlapping circles can produce an 
interesting pattern instead of an area of solid colour. 








OVERPRINTING PROGRAM 


зове $7608 
INK 2 


790600 
z зтопо 
Dorom 


топ Dhan 


ZZnX 


66 6000 95565 
ponz pom 

















FNn 
XOR-LINE ROUTINE 














Start address 57600 Length 20 bytes 

Other routines called Line-draw routine (FNg). 

What it does Draws an Exclusive/OR line on the screen 
between two specified points. 


Using the routine This routine works in the same way as the 
line-draw routine, except that Exclusive/OR allows you to erase 
what has been drawn. Using the routine you can draw lines over 
an image and then remove them again, without affecting the 


original image. As for the line-draw routine, the routine incor- 
porates some error-trapping. 


ROUTINE PARAMETERS 
DEF FN n(x,y.p.q) 






































Xy specify the start pixel co-ordinates of the XOR-line 
(x<256,y<176) 
pq specify the end pixel co-ordinates of the XOR-line 
(р<256, a<176) 
Г ROUTINE LISTING 
sese S760@: LET (-15: LET 


LET b= 
2-8. RESTORE S060 
1-0 TO 1-1; READ a 
(bri),a: LET z-z*a 
i 
8054 LET z-INT (((z7/0)-INT (z^) 


Т 
8055 READ a. IF a«»z THEN PRINT 
ers STOP 


8060 DATA 52,155,50,223,237 
$0561 DATA 205,28,237,62,176 
6062 DATA 50,223,237,201,@ 
8863 бата 13,0,0;,0.,0 


—€—————— | 








OVERPRINTING DISPLAY 








Finally, the overprinting program gives an example of 
the XOR line routine being used to draw over some text 
and cover it (lines 160-170), and then *undraw" the 
lines by calling the routine again in lines 200 and 210, 
leaving the text intact. 





























COMBINING ROUTINES 





The programs on this page give some further examples 
of combining the routines used earlier in this book. You 
will see from the programs used here that, in a program 
of any length. it is a good idea to separate the machine- 
code routines clearly at the beginning of the program, as 
has been done here. 

Although the programs look complicated, they both 
consist mainly of machine-code calls. The repeated 
circles program is a symmetrical pattern; the small 
circles on the circumference ofthe large ones are drawn 
in lines 230-380. Variables x,y, which are points on the 
circumference of a large circle of radius rz. are used to 
determine the centre of the small circles. The actual 
centre points of the small circles are obtained by adding 


REPEATED CIRCLES 
PROGRAM 


00: 18 seconds 


How the program works 
This program displays circles 
with smaller circles on their 
circumference, Each of the 


small circles is then half-filled. 


Line 100 defines ad, the step 
size. 


Line 120 defines х0 and уй. 
the offset from the centre for 
the four large circles, and rx 
and rz, the radius of the small 
and large circles. 

Lines 140-200 draw the large 
circles and the centre box. 
Lines 250-380 draw the small 
circles. 
Lines 400-440 set the colours 
of the four quarters of the 
screen. 





or subtracting an offset (x0,y0) from x and y in lines 
270-340. Variables xm,ym are used to calculate the co- 
ordinates for the fill routine. 

The kite program is even simpler; the only compli- 
cated part is the drawing of the tail (drawn by a sub- 
routine in lines 500-600). The number of bowsin the tail 
can be modified by changing the variable s in line 110. 





REPEATED CIRCLES PROGRAM 


bu, hv, €, b, f) =USR 
b,f)-UsR 


h,v)cUSR EQ4QO 
, 7) =О5Я 589 


с Gus Вомосо 


PAPER 1: INK 6: С 
FN 
FM 
FN 


FN 


3(х1-хо,ч1-чо, 
у ха+хо ,ча-чо, 
jóciexo,g1e40, 


jix21-xo,g1490, 
с2.@,255) 


scroll? 

































































REPEATED CIRCLES PROGRAM CONTD. 


159_RANDOMIZE ска, ма,гжъгк, 
(XL, YL, га-г 
(117,78 ,20,16 
(129,58) 


EH 


FN 


EN 
FN 


тм 
FN gix4XO*1,4-92, 


ғы Xm+KO+L Um +E 


FN ji -x0,u euo, сх 


a 
?гл праз nm 
22 z za 
бо 06 
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опбе-о! 
еңі 21 


FN mixm-xo,un«go) 
FN jix мог, 9,255 


С Ob о N 
32-2 ря 


-6- 000000 5000 66 


FHomtxm,um) 


ән HH 
+h NN 


om mm 
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То 55 5 g- 
во 


mm» 
xz 


RANDOMIZE ЕМ mt2,2) 
RANDOMIZE FN b(9.90,15,11,2, 


RANDOMIZE FN bí18,11,15,11, 
RANDOMIZE FN с(9,0,16,11,6, 
@ RANDOMIZE FN c(16,11.16,11, 


"n 
Ó RANDOMIZE FM b:14,9,2,2,3,0 


обюб 
Ob ро рь рь BOLL 
5 


-ввреювробш 


KITE PROGRAM 


00: 0 1 seconds 


How the program works 
Тһе program draws a kite 
using coloured triangles, and 
then adds a tail with bows. 
Lines 120-130 draw the 
using triangles. 

Lines 150 and 180 sct values 
for the subroutine variables. 
Line 190 sets colours for the 
tail. 

Line 500 is the start of the tail 
subroutine. 

Lines 510 and 520 calculate 
the point x.y, at which an 
ellipse is drawn. 

Lines 530-560 draw and fill 
in each bow. 

Line 570 draws a line between 
each bow. 

Lines 580 and 590 set values 
for the next bow to be drawn. 


ite 











KITE PROGRAM 


де DEF FM b(x.g,h,v, C, b, f) sUSR 
вгвга 
28 DEF FM g(x,u,p.a)-USR ветев 
Зе DEF FN i 1: 9: Рр74а,г,з) -USR 5 
азас 
42 DEF FN ni(x,u)-USR 57700 
108 BORDER 1. PRPER 1: INK 2: с 


13 
110 LET з-46: LET ad-s*PI/128 
LET a-ads647s. LET 15-128: LET x 
1247: LET 51-127 

120 RANDOMIZE FN iix1-40,91,x14 
з ха за+ав) 

BNDOMIZE FN i (x1-40,91,x14 
2,%2,52-50) 

BRNÜOMIZE FN mix1,91) 

LET x22143; 
1+47: LET gi 

со 505 500 

RANDOMIZE ғы 
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х RR 
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о RANDOMIZE 
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RANDOMIZE FN b ta! 
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PAUSE e: srOP 
FOR i=@ TO tt 
LET Xx-X14INT 
LET У 
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4-9) 
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RANDOMIZE 
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NEXT i; Я 
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GRAPHICS EDITOR 1 








Perhaps the most effective way of using machine-code 
routines like those in this book is in a single program 
which enables you to use the routines together. 
Although by this stage in the book you have enough 
routines available to create the kind of sophisticated 
displays seen in much commercial software, you do not 
have what the professionals use: a complete graphics 
editor. This is the purpose of the following program. 


The graphics editor program 

Each stage of the editor program incorporates routines 
from this book. The final program includes a facility for 
SAVEing and LOADing individual screens. The 
displays accompanying the program on this page and on 
the following few pages will give you some idea of the 
sort of pictures you can produce using the completed 
program. 


How the program is built up 

Тһе graphics editor is shown in five stages, with each 
stage complete in itself. By keying in the lines on this 
page, you will have enough of the program to be able to 
move two cursors on the screen. These are used for 
plotting points and drawing lines in future зарэ, 











GRAPHICS EDITOR STAGE 1 


RANDOMIZE FM h (@,0,255,175) 


Der 2,1592 LET сга 
IE cA tae THEN LET etecx: во 


259235 
„280 ТР сх>гзз THEN LET cr-255-c 
езе RANDOMIZE FN ntcx-ci,cg,cx* 


4) 
“246% ЕТ съ-го 
252 IF cGtae THEN LET et=cu: во 


TO 270 
2868 EF су2155 THEN LET cr-i78-c 


"27e RANDOMIZE FN niex,cucci,cx, 


LET шы=7: LET mus 


How stage one works 

Only two machine-code routines are used in stage one. 
The box-draw routine, FNh, draws a line round the edge 
of the drawing area, to prevent the fill routine (added 
later) from “wrapping around" the screen edge. 






































GRAPHICS EDITOR STAGE 1 CONTD. 


mu 
п (mx-mu,mu-mw, 


n (nxamd,mg-má, 


besoe 
бпазаюопохо 


“v 








mx =20 
1020 GO 
1108 LET 
1110 IF 
6 ileo 
1186 LE 
1130 IF 
1220 Go 
aase IF 
СЕТ з<а 
116е GO 
1178 IF 
1160 Go 
1190 IF 
зе 
1200 со 
1210 IF 
1220 Go 
1230 IF 
EE 
1242 co 
1280 TF 
зсгоц 7? 





възереген 
QUE QURE 
004 


The other routine included here is the XOR line 
routine, FNn, used to draw the two cursors. Exclusive, 
OR plotting is used because the cursors have to be able 
to move around the screen and remain visible, without 























disturbing whatever has already been drawn. Try 
moving one of the cursors in this program to a corner of 
the screen to see the XOR effect. The screen border 
remains unchanged when the cursor is moved away 

Line 1000 is the beginning of the main routine. It 
gives initial values to all the variables used in the 
program. These. for example, store values for INK, 


CURSORS DISPLAY _ 



















PAPER, FLASH and BRIGHT. After setting initial co- 
ordinates for the two cursors (points cx,cy and mx,my), 
the program moves to the subroutines. These are stored 
early in the program to increase the running speed. 

The cursor subroutine is at lines 200-280, and the 
cursor is positioned at point cx,cy. The second cursor 
placed on the screen using the subroutine at lines 300- 
370 (points mx.my). These cursor subroutines (called 
cur, mar) are used to delete the cursors before any rou- 
tine is called, and again to put the cursors back on the 
screen afterwards. 


| GRAPHICSEDITORPARAMETERS | 
































| A attribute edit L line 
1 ink = 
了 paper Q window Paper 
о bright/flash МЕЗЕ АН 
ENTER toquitatributeedit $ save screen 
| TES is 
B box T triangle (press Т 
--------+-- again for second 
с corner of triangle) 
S мап E. 
Lp w partial screen clear 
| пое х Text 
E ВАНИЕ ENTER to quit text 
F fill 
G aad АШ these instructions 
gn require you to press CAPS 
j TEE SHIFT followed by the 


letter shown, in upper case. 

















GRAPHICS EDITOR 2 














The second stage of the graphics editor adds routines for 
points, lines and boxes, as well as adding the ink, paper 
and partial screen clear routines. 

Colour is set by the subroutines in lines 400-850. 
These allow you to select colour, BRIGHT and FLASH 


GRAPHICS EDITOR STAGE 2 CONTD. 





values. Points are drawn using the point-plot routine, in БЕ THEN gano 2500 
lines 1320 to 1350. Some of the details in these lines Seo ЕТ жеек SSMO: ТЕ СЕТ 
reappear throughout the program. Line 1320, for даа ТТ масыз ТР) сырты HEN. СЕТ 
example, checks to see if key D has been pressed (ASCII ООО ЕТ Hn ONIS EMBs «схе 
code number 68). If it has; the two cursor subroutines 1598 GO TO 195а 

are called, and the values of cx and cy are used as the co- i228 te Sei TEN В 

ordinates of the point to be plotted. Lines 1360 to 1490 1288 


work in a similar way for the line draw, fill and box rou- 
tines. Line 1500 is a “dummy” line, where other 
routines will be inserted. | 


The grid subroutine 
Lines 1730 to 1790 set up a grid on the screen, by 
GRAPHICS EDITOR STAGE 2 











„Мос, b, f 2USR 


v)-USR 63000 
то 1009 
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=INKEY$: IF 
N GO TO 419 


s 
a E 
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Cex гв»: 
NT tmx 78> - 
IF хсэха THEN LET 
IF ucoum THEN LET 


m 
828 LET h=ABS (хе-хе) +1: LET v= 
{ВЕСЬ +1 


THEN GO TO 1360 
SUB mar 
tex, eu? 


ба TO 1400 
SUB mar 


(mx,my,cx,cu 


GO TO 1440 
SUB mar 
MtCX,cu); LET 





























printing character squares in normal and BRIGHT | into memory by the subroutine at lines 6000 (called in 
alternately. When key G is pressed, a grid drawn Буа | line 120). The grid is used to show character borders on 
machine-code routine appears. The routine is POKE the screen while you are drawing a display. 


GRAPHICS EDITOR STAGE 2 CONTD. GRAPHICS EDITOR STAG JNTD. 











:847,216,17,0,88,1,6 
,9,88,1,128,2,237,17 
55,217,17,0,88,1,19 


55574 STEP 2 
POKE n*1,56 


RANDOMIZE FM с(х,ч,һ,м,с,ь, 


GO TO зае 
THEN GO TO 2240 


M P N 


20129109 900 


GO SUB mar 
а(х, ума 
о то 916 
ке<>69 THEN GO TO 1100 
бо sus 
ба СО SUB 400: GO SUB cur: GO 
mar 
70 RANDOMIZE FN b(x, uh, v.cub, 
ro 
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вв 
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E 
ees 
Sie 
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7S то 55605 STEP 2 
: POKE n*l.180 


$999666- 996: 9 


FOR п-555ее T 


POKE п,а | 
,0,59,1,192,2,17,55 








USING THE GRAPHICS EDITOR GRID | 


The graphics editor grid (CAPS SHIFT and G) is used ro display 
character borders by setting the BRIGHT attributes of alternate 
characters. The grid does not delete anything currently on the 
sereen. The cursor shows the current pixel position, superimposed 
on the grid, In the diagram, the cursor is on the leftmost pixel of a 
character square. 

















GRAPHICS EDITOR FILL DISPLAY 





























GRAPHICS EDITOR 3 








The third stage of the graphics editor adds routines for 
drawing circles and triangles. These routines give you 
many new possibilities for your displays, as you can see 
from those shown here. 


Drawing circles 

Line 1500 is the start of the circle routine. Lines 1510 to 
1530 enable the user to enter start and finish parameters 
between 0 to 360 degrees, rather than the machine 
code’s 0-255 parameter values. Lines 1570 and 1580 


contain some BASIC error-trapping to prevent a circle 
being drawn too far off the screen and causing the 
Spectrum to crash. These lines could be incorporated 
into any BASIC programs which call the circle routines. 


Adding triangles 

Lines 1610 to 1720 are used to store corner co-ordinates 
for a triangle before calling the triangle routine, FNi. 
The parameters of the three corner points are held as 
variables cx,cy, mx,my and tx,ty. 





GRAPHICS EDITOR STAGE 3 


DEF FN у (хуч,г,зв, 
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GRAPHICS EDITOR STAGE 3 CONTD. 
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Lines 1660 and 1670 take advantage of Spectrum 
BASIC’s facility for writing conditional stat i 


SPACE STATION DISPLAY 
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The designs on this page show one method of producing 
a typical display. One general point is worth noting 
before beginning any large-scale graphics editor 
display. Each photograph of the cocktail display 
represents a point where the screen was SAVEd before 
going further to add more details. The reason for this is 
simple: even when you have a little experience with the 
editor, it is easy to ruin a display by adding an 
unintended line, or by filling a shape that is not totally 


GRAPHICS EDITOR 4 


ground. This effect can be obtained by changing the 
initial graphics editor screen to black INK and white 
PAPER colours. A simple change like this can be very 
effective. 


Building up a display 

The cocktail display shown here is an example of how a 
graphics editor display can be developed in stages. Stage 
one of the display uses only lines, squares and triangles. 





BLACK PAINTBOX DISPLAY 





COCKTAIL DISPLAY 1 | 





PAINTBOX DISPLAY 


COCKTAIL DISPLAY 2 = 


























enclosed. Rather than risk losing an entire display, itis | 
sensible to take a few seconds and SAVE what has been 
drawn before continuing. 


The paintbox displays | 
The paintbox displays above show the difference in effect 
which сап be obtained by drawing in white ink on a black | 
background, rather than using black ink on a white back- 


Even at this early stage, however, the design has been 
planned so that there will be no problem with character 
borders when colour is added. The position of character 
borders can of course be checked by using the grid 
(CAPS SHIFT and G). The grid does not delete 
anything which has been drawn, so itis a simple matter 
to flick between the grid and the normal screen as 
necessary at this stage to ensure that lines and points are 




















es ee № 


ee 


drawn in the correct position on either side of a char- also drawn to ta ag acter borders when 
acter border. filled with colour. The colour change on the umbrella 

The second г lies along a horizontal and vertical character border, 

«ample, the cherry in the glass although it appears from the display to be diagonal. 
relatively low resolution of th у, The picture was completed by filling areas and then 
a small circle such as that which forms the y adding colours. When drawing a complex display, it is 
not be completely enclosed. Four single points were always best to keep the filling and colouring operations 
plotted on this circle to prevent the INK from *leaking" until last. Remember that colours should not be 
when the shape is filled. The umbrella in stage three wa added while you are using the grid. 
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GRAPHICS EDITOR 5 








Text is added by lines 1800-1890 of the program. Line 
1810 takes the current pixel position (variables nd 
converts these to character co-ordinates. This is because 
text is printed in character positions rather than using 
pixel co-ordinates, Line 1820 deletes the cursors, and 
line 1830 prints a flashing text prompt at the character 





position. Text is then entered in lines 1840-1870, which 
include BASIC controls for deleting mistakes in keying, 
and ending the text string when ENTER is pressed. 


Attribute editing | 
Lines 1900-2030 give you the option of setting INK, 





BOXES DISPLAY 


PENCILS DISPLAY 


















































PAPER, BRIGHT and FLASH attributes of any Г GRAPHICS EDITOR STAGE 5 CONTD. 
character square on the screen. As with text, the current 
pixel position is converted to character co-ordinates 


(held as variables lin, col) for this routine. Lines 1970 E FLASH i;* 
and 1980 simply move the cursor (a flashing character i Язь" Go то 91a 
square, printed in line 1960) onto the next line ог 1 

column when the end of either is reached. со SUB тас | 


16х78}: БЕТ 


Lin 


Saving and loading screens 

Finally, lines 2040-2130 of the program enable you to 
SAVE and LOAD your displays, using the Spectrum 
SCREENS command. An advantage of this method is 
that you should be able to load onto the graphics editor 
the title display of many commercial games, since these 
programs often begin with a SCREENS display. This SCrOLL? 


“5а 


ж сош 
abn 


In«Z« Зап 
другия 


паров 


zo» 
Опило T 








will enable you to make your own versions of these 
screens. 








GRAPHICS EDITOR STAGE 5 





со зив soo 
зо sue soe 
во sue аза 
со то газа 


„ва THEN со TO ізге Е = с6Р Sus mar 
(c аз КЕТ узгъ SAVE pSSCREENS 


GO SUB mar кес<;74 THEN GO TO 2140 
OVER 1, FLASH INPUT “LOAD 


© 0999 $9056 


P$ 
ó SUB mar 
афЕТМКЕУ : IF LOAD psSCREENS Б 

$4CHR$ 12 THEN GO TO 1 со то 910 


HRS 13 THEN GO TO 18 


вв 12 THEN PRINT СН 
в+ЕнЯ$ 8; LET a$ 
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MULTIPLE LINES 








When using the line-draw routine (FNg), you must 
specify both the start and the end points for each line 
drawn. Where only a few lines are involved, this is not 
difficult, but if you are drawing a complicated shape 
with many lines joined together, you will find yourself 
continually specifying each point twice: once as the end 
ofa line, and then again as the start of the next line. This 
can be avoided by using the multiple line-draw routine 
(FNo). This routine takes a series of co-ordinates which 
have been stored in memory, and joins each point in 
turn to the one before. 

Having drawn your complex series of lines so quickly, 
you now need a way of wiping them off without 
damaging the rest of the display. For this reason an 
Exclusive/OR version of the routine is also included 
(FNp). This routine is the same as the multiple line- 
draw routine, but plots XOR lines. The XOR routine 
will enable you to repeatedly draw and undraw a whole 
series of lines on the screen in a few seconds. 





Putting the points in memory 

Before using the routines, you must specify the co 
ordinates of the points to be linked, which are stored ina 
buffer. In operation, the routine takes a point from 


memory and joins it to the next point, and continues 
until it reaches a y co-ordinate of 255. Points can be 
POKEd into memory by using a loading routine such as 
the one below, which accepts pairs of co-ordinates: 
10 LET n 
20 INPUT 
30 POKE n; 
| 40LETn=n+2 
50 GOTO 20 
400 bytes from 57200 are reserved in memory for this 
purpose, so you can draw 199 lines with the routines. 
These routines are especially useful for plotting the 
same shape on the screen repeatedly, since points once 
stored in memory can be called by the routine almost 
instantaneously. 
















ellipse. The shape is then filled. 
Lines 140-330 POKE into 
memory the values of points 
around the edges of the screen. 
Lines 350 to 400 POKE into 
memory points on an ellipse. 
Lines 410 and 420 POKE 
values of 255 to complete the 
table of points. 


MULTILINE PROGRAM 


00:22 seconds 


How the program works An 
explosion effect is obtained by 
drawing a continuous line 
joining points on the edge of 
the screen with points on an 
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go LET Latte 
за NEXT i 

320 FOR і-ә TO 97 STEP s 

10 POKE i 

58e POKE LET tates 
330 NEXT 

Зад LET 

350 FOR $TEP 4 
360 LET 2+с05 a» 
370 LET Q*SIN a) 
360 POKE E z*i4i,x 
See LET 

106 
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130 
440 
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The multiline program draws a long sequence of lines, 
which are then filled by the fill routine. Both routines 
must be in memory for the program to RUN. 





DISPLAY BEFORE FILLING 




















Start address 57000 Length 20 bytes 











Start address 57100 Length 40 bytes 

Other routines called Line-draw routine (FNg). 

What it does Draws a series of lines on the screen, from a 
specified list of co-ordinates. 





Using the routine Co-ordinates of lines to be plotted are 
stored in a table at memory location 57200. Up to 200 lines сап 
be stored in this area of memory. Points in the table must be 
specified by the y co-ordinate (0<—y<—=175) followed by the 
x co-ordinate (0<=х<=255), rather than the other way 


round. 

To stop the routine POKE specify a y co-ordinate of 255. The 
routine will continues plotting points until it reaches this y co- 
ordinate; if you omit the 255, the routine will continue to plot 
points using whatever numbers are in memory after the co- 
ordinate table. 








8100 LET b-57100. LET (235. LET 
2-9: RESTORE 8110 
8101 FOR і-Ө TO (-1 READ а 
8102 POKE (b+id,a: LET z-z*a 
$103 NEXT i 
81Ө2 LET z-INT (((z/0)-INT (2/00 
* 
105 READ з: IF а‹›= THEN PRINT 
“72: вто! 
8110 DATA 33,112,223,94,35 
8111 DATA B5,237,82,26.237 
8112 бата 35,126,254 ,255,32 

| 8113 DATA 1,201,95,35,86 
8114 DATA 43,229,42,26,237 

| S115 DATA 205,51,237,225;24 
8116 DATA 225,0,0,0,óÓ 

| 8117 DATA 17,6,6,.6,6 








Other routines called Multiple line-draw routine (FNo). 
What it does Draws a series of Exclusive/OR lines on the 
screen, using points specified in a table. 


Using the routine This routine works in the same way as the 
multiple line-draw routine, but can be called twice with the same 
table of co-ordinates to erase the lines drawn. Remember as 
before to POKE points in the order y,x. Co-ordinates are stored 
in memory from location 57200, and the final point must be 
followed by a y co-ordinate of 255. 
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b=S7@0@- LET L=1S: LET 
RESTORE 5160 

FOR i-O0 TO 0-1 
Е (bei),a 


RERD a 
LET z=zea 





NEXT i 

LET z-INT ((tzz1)-INT (2/43 
RERD a 
STOP 


го-офошна 
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IF az THEN PRINT 


DATA 62,158,50,223,237 
DATA 205,12,223,62,176 
5@,253/237,201,0 | 
DATA 15,0.0,0,0 
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MAGNIFICATION AND REDUCTION 1 





One of the most dramatic uses for machine code is to 
magnify a portion of the Spectrum screen. The principle 
behind magnification is straightforward. To double the 
size of a single byte, for example 00110010 (a value of 
50 in decimal), simply rotate it left one bit, thus making 
01100100 (which is equivalent to 100 in decimal) 
Using this principle of doubling, you can magnify whole 
sections of a screen. The magnification routine, FNq, 
given here, is based on this idea. The routine simply 
requires you to specify the screen area to be enlarged. 
The magnification routine is accompanied by a 
reduction routine, FNr, which is used to reduce an 
already-magnified area. The reduction routine actually 
forms part of the magnification routine, with the start 
address of the second routine being a call which “hooks” 
into the main routine, The reduction routine restores 
the screen as it was before the magnification, and works 
by the magnification routine saving the entire screen 
each time it is called before magnifying any area; the 
reduction routine simply displays this area from 
memory on the screen. Each time the magnification 

















Remember that the magnification program calls the 
multiline routine, FNo, to draw the background 
pattern; this routine must also be present in memory for 
the program to RUN correctly. 


MAGNIFICATION PROGRAM 





She 
noo 
опт 
271 


юкееерененин 


Le 





15335911 


S 
e 
ә 
а 
2 
ә 
2 
o 
o 
tj 
5 


В 
5 
E 
с 
N 


оул ОЮ 


"1292 





27 


D2027H2 
229 














































































routine is called, therefore, any former stage of magnifi- 
cation is deleted from memory, so the reduction routine 
can only be used to reduce a magnified area once. 


The magnification program 

This program uses the magnification routine to 
repeatedly enlarge a part of the screen. By adding the 
following lines: 


30 DEF FNr()=USR 56957 
280 RANDOMIZE ЕМг() 
you can incorporate the reduction routine into the 


program. This will have the effect of reducing the 
enlarged area to its last state. 




















MAGNIFICATION | 
PROGRAM 


00:05 seconds 


(to magnify area) 







How the program works 
Lines 110-220 use the 
multiline routine to draw a 
series of lines. 

Lines 130-200 POKE co 
ordinates of the lincs to be 
drawn. 

Line 230 waits for text to be 
entered. 

Lines 240-270 magnify the 
area with text five times. 
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MAGNIFICATION ROUTINE 








LISTING FOR BOTH ROUTINES 











Start address 56700 Length 290 bytes 
What it does Magnifies a specified screen area to double its 
previous size. 


Using routine The routine uses character co-ordinates, 
as in the window ink and paper routines (FNb and FNc), rather 
than pixel co-ordinates. Remember that these start from the 
top left-hand corner of the screen. The routine can be used to 
magnify the same area repeatedly, increasing the enlarge- 
ment each time. 

Since an area is doubled in size by the routine it is easy when 
magnifying to make part of the area disappear off the screen. 
To prevent crashes occurring, use the tests in the parameter 
table to make sure that the area when enlarged will not be off 
the screen. These tests can be incorporated into your 
programs. 





ROUTINE PARAMETERS 
DEF FN q(x,y,h.v) 
specify top left-hand corner of area to be magnified 


ху 
Ү Lx<32， y<22) EN 























һу specify horizontal and vertical sizes of area 
(x+(2#h) «32 y--(2«v) <22) 























8200 LET b-S6700: LET (-гәз: LET 
=@: RESTORE S219 
FOR i-O TO \-1: READ a 
5202 POKE (b+i),a: LET z-z*a 


MEXT i 

3294 LET z-INT (((z^i)-INT (z^) 
8295 READ a. IF a:»z THEN PRINT 
227". STOP 
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REDUCTION ROUTINE 








Start address 56957 Length 290 bytes 
What it does Reduces a previously enlarged routine to its 
original size. 


Using the routine Each time the magnification routine is 
called, it saves in memory the screen as it was before magnifi- 
cation. The reduction routine simply displays this saved screen, 
Thus the reduction routine cannot repeatedly reduce an area on 
the screen; it will only show whatever was on the screen before 
the last magnification. 








MAGNIFICATION AND REDUCTION 2 








The program on this page gives an indication of the 
capabilities of the magnification routine. From an 
initial display, the magnification routine is called three 
times to enlarge different areas of the screen. As a 
further sophistication, these enlarged areas are then 
coloured using the window paper routine, and a line is 
drawn around the edge of each area. 

The various shapes are drawn by different sub- 
routines at lines 300, 400, 500 and 600, and each shape 
is drawn higher up a column by increasing the y co- 
ordinate before calling the subroutine. After a single 
column has been completed with five shapes, the display 
is repeated by the loop beginning at line 110 which setsa 
new value for the x co-ordinate. 

After the subroutines have been completed, line 700 
uses the magnification routine for the first time. Each 
time an area is magnified, the box routine is then called 
то draw а black line around the edge of the enlarged 


SWEETS PROGRAM 
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area (in this case, line 710). After a pause, the new area 
is coloured, and another area is enlarged. 


Relocating areas in memory 

The magnification routine works by storing in memory 
whatever is on the screen in the specified area. It uses 8K 
of memory, stored from location 30208. If your BASIC 
program is particularly long, you may find that this area 
is required by your program. By POKEing the following 
three numbers: 

POKE 56793,176 

POKE 56950,176 

POKE 56959.176 


you can place the code about 18K higher in memory. 
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SWEETS PROGRAM 


00: 13 seconds 


How the program works 
А series of objects is placed on 
the screen, and the 
magnification routine used to 
enlarge various parts of the 
display 

Lines 130-220 call 
subroutines to draw the 
pattern of sweets, 

Lines 300-670 form the 
subroutines which draw the 
sweets. 

Lines 700-710 magnity the 
top left-hand area (coloured 
green in line 730). 

Lines 750-770 magnify the 
top right-hand area (to four 
times its normal size). 

Line 790 colours this area 
cyan. 

Lines 810-820 magnify the 
third area, 

Line 840 colours this area 
magenta. 
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The BASIC commands SAVE SCREENS and LOAD 
SCREENS, used to save and load displays, have the dis- 
advantage that they require nearly 8K of memory to 
save any display, no matter how simple. The screen 
compaction routine, FNs, allows you to store screens in 
a fraction of this space: the simpler the display, the less 
memory is required by the routine to store it. Even 
highly complex screen displays are stored in 
considerably less than 8K. As a guide, the three displays 
on this page require a total of just under 12K. 
Previously saved displays can be displayed again 





COMPACTION 
PROGRAM 


(30000) where the first display 
is to be stored 
Line 120 PRINTS this 


е address, 
00 U3 seconde Line 140 compacts the 
How the program works display. 


Line 150 PEEKs start values 
for the next display. 

Lines 160-200 repeat the 
operation for the other screens. 
Lines 300-350 display the 


screens in turn. 


Three screens are loaded using 
SCREENS, compacted, and 
then displayed again in quick 
succession. 

Line 110 sets values for high 
and low bytes of the address 

























































































using the decompaction routine, FNt. For both 
routines, the memory location of a display is specified by 
two parameters, containing the high and low bytes 
respectively of the start address. 


COMPACTION - DECOMPACTION PROGRAM 
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FNs 
SCREEN COMPACTION ROUTINE 








FNt 
SCREEN DECOMPACTION ROUTINE 














Start address 56600 Length 65 bytes 
What it does Saves the current screen in a compacted form in 
memory. 


Using the routine Parameters h and | are calculated by the 
formula m 

10 LET h=INT (store/256) : LET I—store—256*h 

where "store" is the address in memory at which the screen is 
lo be stored. 

After storing a screen, you can find the start address for the 
next screen to be stored by PEEKing locations 23297 and 
23296 (for h and |, the high and low bytes respectively of the 
address). This should be done immediately after compacting a 
display. 








Start address 56500 Length 45 bytes 
What it does Decompacts a screen previously stored at a 
specified address. 


Using the routine This routine puts back onto the screen a 
routine previously stored by the compaction routine. The 
decompaction routine loads screens much more quickly than 
the LOAD SCREEN$ command. 

To obtain the start addresses (h and 1) of each screen com- 
pacted by the compaction routine (FNs), PEEK locations 23297 
and 23296 (for h and |) after compacting a screen. 


ROUTINE PARAMETERS 
. DEF FN t(h.l) 














ROUTINE PARAMETERS. 








DEF FN (в) 








specify the high and low bytes of the data for the. 
screen respectively (h,|<255) 


[m] 











ROUTINE LISTING 
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ы specify the high and low bytes of the data for the 
T screen respectively (п/<255) 














ROUTINE LISTING 











50 LET ь-зезе LET 1-35 LET 
2: RESTORE 8360 

51 FOR 150 TO 1-1: READ а 

52 POKE (bsi),a. LET zez*a 

53 NEXT i 

54 LET z=INT (| (INT (аи 
L 

55 READ a. IF a«»z THEN PRINT 

















COMPACTION PROGRAM: SAMPLE DISPLAY 

















The displays on this page were produced using the 
graphics editor, stored by the compaction program and 
then displayed in succession. The start addresses in 
memory (variables h,]) of any screens you draw will 
obviously differ from those given here. 





























































































































The table shown below gives a summary of all the | programs. If you have not used a routine before, you are 
machine-code routines used inthisbook.Thistabledoes | recommended to read the introduction to the routine оп 
not explain every detail of using each routine; it is | the appropriate page of the book before using it in your 
intended only as an aid when using the the routines in your program. 
ll partial screen clear FNa(x,y,h,v) x,y startco-ordinates character 
h.v horiz. 4- vert. increment character 
ll window ink FNb<«,y,h,v,c,b,f) х,у start co-ordinates character 
hv horiz. + vert. increment character 
c colour i 
bf | BRIGHT or FLASH = 
13 window paper FN¢e(x,y,h,v,c,b,f) х,у start co-ordinates character 
h.v horiz. + vert. increment character 
c colour -- 
Са > bf BRIGHT or FLASH 一 
15 enlarged horizontal text FNad(x,y) ху i _ Character 
15 11: ertical text __FNe(x,y) х,у character 
17 point-plot FNf(x,y) ху — Start co-ordinates pixel 
21 line-draw FNg(x,y,p,q) х,у — startco-ordinates pixel 
Pq end point co-ordinates 
25 box-draw FNh(x,y,h,v) х,у start co-ordinates 
Р hv horiz. + vert. increment L 
27 triangle FNiG;y,p.q.r,s) х,у start co-ordinates 
ра co-ordinates of second point 
> __ 158 co-ordinates of third point 
29 squares table =. = "Ж. 
29 тақа 245 72-77” 22. Е 
31 агс FNj(x,y,1,5,f) ху start co-ordinates pixel 
r length of radius pixel 
sf start and finish point ofarc - 一 _ a 
3 sector FNK(x,y,1,s,f) ху = startco-ordinates pixel 
r length of radius pixel 
sf start and finish point of arc E 
33 segment FNIG,y,r.s f) ху start co-ordinates pixel 
r length of radius pixel 
s,f start and finish point of arc — 
35 fill FNm.y) х,у — startco-ordinates character = 
39 XOR-line FNn(x,y,p,q) Xy start co-ordinates pixel | 
ра co-ordinates of second point pixel | 
53 multiple line-draw FNoÜ 
53 multiple XOR-line draw FNpO TE l 
55 magnification FNq(x,y,h.v) Xy start co-ordinates character 
h.v horiz. 4- vert. increment character. 
55 reduction ЕМ№0 
59 compaction ENs(h.l) hi high and low bytes 一 
59 decompaction ЕМ) hil high and low bytes 一 














REG ie) a I c KOC 


Before using a routine you must first define it in your 
program using DEF FN followed by the correct number 
of parameters. Parameters passed to machine-code 
routines must always be whole numbers; if a parameter 
value is calculated by your program, then put an INT 
statement in front of it to ensure a whole-number value 
is passed to the routine. 













































































ranges bytes address check 
0-32 and 0-24 100 63000 82 
0-32 and 0-24 
0-32and 0-24 135 62800 53 
0-32 and 0-24 
4 0-7 
0-ой, 1—on 
| 0-32 and 0-24 150 62600 19 
0-32 and 0-24 
| 0-7 
| 0=off, 1=on 
B 03240-24 220 62200 0 
0-32 and 0-24 215 61900 109 _ 
227 0-255ап40-176 65 61500 24 
| 0-255 and 0-176 215 60700 192 
0-255 and 0-176 
0-255and0-176 110 60400 86 
0-255 and 0-176 Е 
0-255 and 0-176 80 60300 68 
0-256 and 1-176 
0-256 and 1-176 
60 59600 3 
1 я 525 59000 234 
1 0-255 and 0-176 45 58900 17 
0-255 
0-255 i 
0-255 and 0-176 45 58800 35 
0-255 
| 0-255 
0-255 and 0-176 30 58700 18 
0-255 
0-255 
0-32 and 0-24 195 57700 57 
0-255 and 0-176 20 57600 13 
0-256and 1-176 
40 57100 17 
20 57000 13 
0-32 and 0-24 290 56700 38 
0-32 and 0-24 
56957 
0-255 65 56600 56 
0-255 40 56500 28 



























































MEMORY MAP 
This chart shows how the Spectrum memory is organised when all 
the routines are present in memory. RAMTOP should be set to 
55500 using a CLEAR command. 

Code Title Address 
FNa partial screen clear 63000 
FNb window ink 62800 
FNc window paper 62600 

100-byte buffer 62500 

FNd enlarged horizontal text 62200 

[Se eee 

FNe enlarged vertical text 61900 
300-byte buffer 61600 

ЕМЕ point plot 61500 
FNg line draw 60700 
FNh box draw БЕСС. 60400 
FNi triangle draw 60300 
600-byte buffer 59700 

squares table 59600 

master curve 59000 

FNj arc 58900 
ЕМК зестог 58800 
ENI section. 58700 
FNm| fill 57700 
FNn exclusive /ORine draw 57600 
400-byte buffer 57200 

FNo multiple line draw 57100 
ЕМр multiple ХОВ ше draw | 57000 
FNq magnification. 56700 
ENr reduction 56957 
FNs compaction 56600 
FNt decompaction. 56500 








НИЕ 


ERROR TRAPPING 








Error trapping in BASIC is carried out when an error 
message is displayed to show a mistake has occurred. 
This message is produced by a routine in the Spectrum 
ROM which prints on the screen the nature of the error. 
When using machine code, however, it is often 
difficult to place restrictions on the way the routines are 
used, In most cases a determined user will be able to 
make the routine crash simply by passing it information 
which it does not understand. This could be checked 
within the machine-code routine itself to ensure that 
whatever is inputted is within the possible ranges you 
can type in, but to do this for all the routines in this book 
would require each routine to be perhaps doubled in 
length to incorporate the error checking required. 








Preventing likely errors 
In some cases it is quite easy, as well as helpful for the 
user, to add at least some error checking. A check 
routine has been added to the point-plot routine, for 
example, which means that although you may get 
rather unexpected results when you plot off-screen 
points, the routine is unlikely to crash. Try plotting a 
point which is off the screen and you will see the effects 
a point will appear, but since the point specified is off 
the screen the routine will try to make sense of the data 
and plot a point at a position on the screen. 





Error-trapping with the line-draw 
routine 
Another part of the machine code which contains 
some error checking is the line-draw routine, as you can 
see from the error demonstration program shown here. 
Specifying lines off the top or bottom of the screen will 
result in “Integer out of range” being displayed, as 
happens when the program below is RUN with the co 
ERROR DEMONSTRATION PROGRAM 





газ 
1за NEXT 3 














PLOTTING OFF THE SCREEN VERTICALLY 





ordinates shown. Errors in horizontal co-ordinates are 
more difficult to trap, since these co-ordinates lie 
between 0 and 255, the range of numbers that can be 
contained in one byte. If you use a number larger than 
t is likely to be treated as if it were 255 less than its 
actual value, with the result that the line wraps round to 
the other side of the screen. This effect can be seen in the 
screen below, the result of specifying parameter values 
which are off the screen horizontally. 

PLOTTING OFF THE SCREEN HORIZ! ALLY 




















A similar effect can be seen with the curve routines, 
which cause odd effects when they go off the sides of the 
screen, but which will work within limits off the top and 
bottom of the screen. 

The error trapping in these routines covers only the 
most likely errors you may make when using the 
machine code. As far as possible, you should keep to the 
limits and parameters specified for each routine. 








GRAPHICS GRIDS 

















































































































































































































This grid shows screen divisions for both pixel and hand corner of the screen across and down, Pixel co- 
character co-ordinates. Points on the screen are defined ordinates are measured from the bottom left-hand 
by co-ordinates x (horizontal) and y (vertical). corner across and upwards. Pixel co-ordinates do not 
Character co-ordinates are measured from the top left- cover the bottom two lines of the screen. 
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Main entries are given in 
bold type 


AND 38 

Arc pattern program 30 
Arcroutine 30-1 
Attribute editing 50-1 


Background colour 12 
BASIC 6-7,9 

Billiard ball display 47 
Box-draw routine 25 
Box fill program 35 
Boxes 24-5 

BRIGHT 10,12 


Characters 
co-ordinates 63 
enlarging 14-15 
Circles 
graphics editor 46 
master curves 
routine 28-9 
ways of drawing 28 
Cityscape program 
18-19 
CLEAR 8 
Cocktail displays 
Colour 10-13 
background 12 
changing 10 
irregular shapes 34 
partial screen clear 
routine 10-11 
window ink 
routine 10-11 
Compaction 
program 58-9 
Cones program 31 
Cosine curves 
program 16 
Cube program 20 
Cursor subroutines 


48-9 


43 


DRAW 20 


Enlarged horizontal text 
routine 14-15 
Enlarged vertical text 
routine 14-15 
Erasing 38-9 

Error trapping 62 
Exponent curves 


program 17 


ЕШ routine 34-5 
FLASH 10,12 
[Functions 9 


(Graphics editor 7, 
42-51 

attribute editing 50-1 
cocktail displays 48-9 
cursor subroutines 43 
drawing circles 46 
grid subroutine 44-5 
loading 51 

paintbox displays 48-9 
parameters 43 
program 42 

saving 51 
triangles 
Grids 63 
character 
co-ordinates 63 
pixel co-ordinates 
graphics editor 
subroutine 44-5 


46-7 


63 


INK 10 
Interference circles 
program 39 


Kite program 41 


Line-draw routine 
20-3, 52 
error trapping 62 
Line graphics 20-3 
Line interference 
program 23 
Line pattern 
program 22 
Loading 
displays 51, 58-9 
machine code 8,9 


Machine code 6-9 
boxes 8 
disadvantages 6 
error trapping 62 
loading 8,9 
saving 8-9 
using 8-9 








Machine code 
routines 6-9 


checklist 60-1 
Magnification program 
54-5 

Magnification 
routine 54-5 
Master curve routines 
29 

Memory 

clearing 8 
map 61 
Mondrian painting 
program 12-13 
Multiline program 
Multiple line-draw 
routine 52-3 
Multiple XOR-line 
routine 52-3 


82-8 


NOT 38 


ОК 38 

OVER 38 
overprinting 38-9 
Paintbox displays 48-9 
PAPER 12 

Partial screen clear 
routine 1l 
Perspective boxes 
program 25 
Pictures 
with lines 
with points 
Pixel co-ordinates 
Planet program 17 
PLOT 16 
Point-plot program 
flowchart 7 
Points 
pictures with 
storing 52 
Pyramid program 22 


20-3 
16-19 
63 


16-18 


Radiating box 

program 25 
RANDOMIZE 9, 16 
Reduction routine 54-5 
Repeated circles 

program 40-1 
Repeated triangles 

program 26 
RESTORE 9, 12 


Saving 
displays 51, 58-9 | 
routines 8-9 








| Sweets program 57-8 


Screen compaction 
routine 58-9 
Screen decompaction 
routine 58-9 
SCREENS 51, 58-9 
Sector program 32 
Sector routines 32-3 
Segment program 33 
Segment routine 32-3 
Shapes, filling 34-7 
Space station display 47 
Spiral program 37 
Spotlight program 27 
Squares, drawing circles 
using 28 

Squares and circles 
program 36-7 
Sunset program 20-1 


Text, enlarging 14-15 
Triangle curves program 
27 
Triangle draw routine 
26-7 
Triangles, graphics 
editor 46-7 
Window ink routine 11 
Window paper 
routine 13 


ХОК ellipse program 38 
XOR-line routine 38-9 
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The bestselling teach-yourself programming course now takes you 
beyond BASIC to the world of advanced machine-code graphics. 


ЕТ collection of tailor-made, ready-to-run machine-code routines, this 
Е ТЕ book shows you how їо produce precision, high-resolution graphics 
T ina fraction of the time they would take in BASIC alone. A keyboard- 
| driven graphics editor and a wide variety of demonstration 
programs will Hele you open up the full potential of the ZX Spectrum 
—without the need for any knowledge of machine-code 


] 
| 
| 
Using а combination of simple BASIC programming and a | | 
| 
| 
| 
| 
programming. | 


Together, Books Three and Four in this series form a complete, 
self-contained graphics system for Spectrum-owners. 


All the programs in this book run on both 48K ZX 
Spectrum and ZX Spectrum+ machines. 


€€ Far better than anything else reviewed on these pages... 
| Outstandingly good 99 
r4 BIGK | 
| 66 As good as anything else that is available, and far | 
(ӘДЕ better than most 99 | ] 
ІЗІ COMPUTING TODAY ШЕ 


66 Excellent... As a series they could form the best ‘basic = 
| introduction’ to programming l've seen 99 
POPULAR COMPUTING WEEKLY 


A new generation of software 


Entertainment е Education е Home reference 
Send now for a catalogue to Goldstar, 1-2 Henrietta Street, London WC2E 8PS 
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THE DK SCREEN-SHOT PROGRAMMING SERIES 
Never has there been a more urgent need for a series of well-produced, 
straightforward, practical guides to learning to use a computer. It is in 
response to this demand that The DK Screen-Shot Programming Series 
has been created. It is a completely new concept in the field of 
teach-yourself computing. And it is the first comprehensive library of 
highly illustrated, machine-specific, step-by-step programming manuals. 


BOOKS ABOUT THE ZX SPECTRUM 
This is Book One in a series of unique step-by-step guides to 
programming the ZX Spectrum. Together with its companion volumes, it 
will build up into a self-contained teaching course that begins with the 
basic principles of programming, and progresses - via more 
sophisticated techniques and routines — to an advanced level. 


BOOKS ABOUT OTHER COMPUTERS 
Additional titles in the series will cover each of the world's most popular 
computers. These will include: 
Step-by-Step Programming for the BBC Micro | 
Step-by-Step Programming for the Commodore 64 





Step-by-Step Programming for the Acorn Electron 
Step-by-Step Programming for the Apple il 
Step-by-Step Programming for the IBM PCjr 


IAN GRAHAM 

After taking a B.Sc. in Applied Physics and a postgraduate diploma in 
Journalism at The City University, London, lan Graham worked as 
assistant editor of Electronics Today International and deputy editor of 
Which Video? Since becoming a full-time freelance writer in 1982, he has 
contributed to a wide range of technical magazines (including Computing 
Today, Video Today, Video Search, Hobby Electronics, Electronic Insight, 
Popular Hi-Fi, Science Now, and Next...) and has also written a number of 
popular books on computers and computing. These include Computer & 
Video Games, Information Technology, The Inside Story — Computers, 
and The Personal Computer Handbook (co-written with Helen Varley). 
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9 Volt DC socket The 
Spectrum is supplied with 


à power adaptor that 


SPECTRU M transforms the high- 
voltage alternating current 
(AC) supply into a 9 Volt 
22 mm S LY - direct current (DC) supply 
Since its launch in April 1982, the ZX Spectrum has suitable for the computer, 
become one of the most popular home computers 
available today. Despite its small size, it is potentially 
very powerful. It contains the same basic components 
as much larger computers and uses its own version or 
“dialect” of the most popular home computer language, 
BASIC. The Spectrum offers an inexpensive way of 
learning to program a computer with many of the 
features found in larger, more elaborate systems. 

Two versions of the Spectrum are available. They are 
identical but for the size of the memory — the 48K model 
can hold more information than the 16K version. The 
48K model has a memory capacity which is greater than 
many more expensive personal computers. All the 
programs in this book will work equally well on either 
the 16K or 48K machine. ZX Spectrum 





Connectors and peripherals 

From the outside the Spectrum seems to be little more 
than a slim black case with a keyboard on top, which is 
composed of soft moving keys. Although it looks like a 
typewriter keyboard, it is actually very different. As 
you can see on pages 10-11, each key can produce 
whole words as well as letters, and when used in 
programming, each key can perform up to six different 
functions. 

If you turn the computer around so that you are 
looking at its back panel, you will see that there are four 
sockets and a slot. The small sockets connect the 
Spectrum to a television, cassette recorder and power 
supply. You can find out how to use a cassette recorder 
with the computer on page 60. The longer slot is the 
edge connector, which is actually a part of the 
Spectrum’s circuit board exposed at the edge of the 
computer casing. The metallic strips on the edge of the 
board are used to connect extra pieces of hardware, 
such as printers, microdrives or joysticks, to the 
computer. When you are handling the computer, do 
not touch any of these contacts, as grease and dirt can 
cause mulfunctions if you later use the edge connector 
with any “peripherals”. 

The Spectrum produces a colour television picture, 
but it can also be viewed in black and white. In this case, 
the different colours show up as shades of grey. The 
computer itself produces all the sound effects used in 
programs. If you turn the Spectrum over so that you are 
looking at the bottom panel, you will be able to see the 
circle of holes in one corner that is the sound outlet for 
the Spectrum’s tiny loudspeaker. It is capable of 
beeping or playing simple tunes. 


























Edge connector This 
multi-terminal socket 
connects the compute 
with a range of hardware 
including the Spectrum 
printer, Microdrive units 
and "analogue" c rols 
such as games joysticks 


MIC socket When this 
connected to a cassette 
recorder's microphone 
socket, programs can be 
transferred from the 


computer to be stored on 
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EAR socket This socket 
allows the Spectrum to 
receive stored programs 
from a tape cassette. 1t 18 
connected to the cassette 
recorder’s EAR socket 


INPUT 


K 


ГУ socket The picture 
ignals that the Spectrum 
produces are fed into a 
television's aerial socket 
from the Spectrum's TV 
socket, using a cable 
supplied with the 
computer 


@ 


















The ZX Spectrum is constructed on a single printed 
circuit board. The major components are integrated 
circuits, or “chips”, which look like thin rectangular 
slices of black plastic with up to 20 metal pins 
protruding from each edge. These connect the chips to 
contacts which run over the surface of the board. 

At the heart of the Spectrum is a microprocessor 
which makes up the computer’s Central Processing 
Unit (CPU). The CPU does all the computer's 
calculations, monitors the keyboard and acts on any 
key-presses it detects. But despite the CPU's 
complexity, it can only follow instructions that it is 
given. The instructions you type on the keyboard must 
first be translated into the numerical machine code that 
the computer works in. 

The program required to perform this translation is 
stored permanently in a Read Only Memory (ROM), 
also known as a “non-volatile” memory. This memory 
is not free for you to store your own programs in - its 
contents can only be read. The program is unaffected 
by the computer being turned on or off. 

The Spectrum's Random Access Memory (RAM) 
offers storage space for the user. Everything you type in 
on the keyboard is stored in RAM until you either type 
in the keyword NEW or switch off the power. Because 
the contents of RAM are erased when the power is 
interrupted, it is also called a “volatile” memory. 


Main board components 

The two versions of the Spectrum are distinguished by 
the size of their RAMs - 16K and 48K. The K stands 
for kilobytes, each equivalent to 1024 bytes. A byte is a 
standard piece of electronic information in binary form. 
It is made up of eight bits — pulses of electricity which 
each represent a 0 or 1. Bytes сап be thought of as acting 
like words in the computer system, with bits being the 
letters. The main difference between the Spectrum's 
system of communication and English is that computer 
words are all eight letters long, and are made up from an 
alphabet containing only two letters. The Spectrum 
does everything from producing colour television 
pictures to playing tunes by using this binary code. 

All the computer's activities are synchronized so that 
the correct information is available in the right place at 
the right time. This synchronization is achieved by an 
internal clock. The clock is based on a crystal oscillator 
that “ticks” at the rate of 3.5 million pulses per second. 
Additional timing and control operations are provided 
by a large chip called an Uncommitted Logic Array 
(ULA), which carries out complicated logic functions. 











'The microchip command instructions it needs to carry 





chain All the chips within out the computer’s 
the Spectrum form an functions, 
electronic chain of In this view of the 


command, with the CPU computer’s interior, the 
performing all the executive “ connectors that link the 
tasks. Therestofthechips- ^ keyboard to the rest of the 
including the RAMs, ROM computer have been р 
апа ULA ~ асг as temporary detached. It is advisable not 
or permanent information to open your Spectrum as 
storage systems. These these connectors can easily 
supply the CPU with the be broken. 


Uncommitted Logic Array = 


(ULA) This provides additional 
timing and control functions 
that are not stored by the 
permanent program contained 
in the ROM, 













Phase Alternation Line (PAL) 
encoder This converts the 

stream of data produced by the 
Spectrum into a high-frequency 
signal that can be fed into a 
television. 


Random Access Memory 
(RAM) Eight RAM chips 
provide 16K of storage for all 
the programming information 
that the computer is given after 
being switched on. The second 
group of eight further RAM 
chips provides an additional 
32K of memory in the 48K 
version of the Spectrum. 


























Cassette recorder sockets 
These are used to record or play 
back programs. 


/ 


: Logic chips This area deals 
NS with a variety of logic functions 
N including those needed to 






















қ “interface” with hardware Central Processing Unit Read Only Memory (ROM) 
ENS linked to the computer. (CPU) The executive part of 
М the computer. This 
microprocessor carries out all 
calculations and controls computer’s most important 
activities in the rest of the chip, the CPU, can understand. 
computer, drawing on Unlike RAM, its contents do 
information held in both ROM not disappear when the power is 
and КАМ. switched off. It contains the 
computer’s BASIC interpreter. 


This chip contains the 
instructions necessary to turn 
programs into a form that the 








9 Volt DC socket The power 
supply socket. 


Voltage regulator This 
prevents changes in voltage 
disrupting the activities of the 
computer, 





Loudspeaker The speaker 
produces notes and sound 
effects when called on by a 
program. 


















THE SPECTRUM 
KEYBOARD 


On a conventional typewriter keyboard, each key is 
used to print a lower case letter and (with the shift key) 
the upper case version of the same letter. The Spectrum 
keyboard works like this, but because it has more than 
one shift key, it is much more versatile. The keys on the 
Spectrum are capable of selecting as many as six 
different functions. The 40 Spectrum keys can produce 
a total of around 200 letters, words and symbols. You 
may find using the keyboard a slow process to begin 
with, but once you have mastered the use of the shift 
keys, finding your way around all the different words 
and symbols will soon become second nature. Two 
different kinds of shift key - CAPS SHIFT and 
SYMBOL SHIFT - are used either independently or 
together to select key functions. 





Keyboard technique 
The Spectrum keys are moving, calculator-style 
buttons. Every time one is pressed, making a character 
or word appear on the television screen, the computer 
produces a single click to let you know that the contact 
has been made. If you hold a key down for more than a 
couple of seconds, the symbol is repeatedly printed. 
You don't have to be an accomplished typist to use 
the keyboard. The Spectrum saves you a lot of typing 
because the command words used by the computer 
need not be typed out in full. Pressing a key once makes 
the whole word printed on the key appear on the 
television screen. To help you further, commands and 
symbols that are often used together in programs are, 
wherever possible, grouped on adjacent keys. 


Understanding the cursor 
'The Spectrum accepts instructions only if they are in a 


logical sequence, and it actually tells you what kind of 


instruction or symbol it expects by showing one of five 
flashing cursors. If the cursor is a “К”, the computer is 
expecting you to supply a keyword next. This is simply 
any of the command words in white on the keyboard. 
So, if you press the P key, the word PRINT, and not the 
letter P, appears on the screen. If the cursor is flashing 
“L”, pressing the P key produces a lower case letter p 
on the screen. To produce a capital P, press the CAPS 
SHIFT key while pressing p. This will make the cursor 
change briefly from “L” to “C” to show that capitals 
have been selected. The “G” cursor will appear when 
you use the GRAPHICS key, while the *E" (extended 
mode) cursor will appear when you use the shift keys to 
select keywords printed on the keyboard in red or 
green. It reverts to “L” after ENTER is pressed. 





Number keys These offer a 
quick and easy way of 
producing graphics when they 
are used after pressing CAPS 
SHIFT with GRAPHICS. 
The graphics symbol on the 
number key will then appear 
on the screen. Keys 0 to 7 also 
control the colours produced 
on the screen. 


ZX Spectrum 


EDIT This is used to 
"extract" a line from a 
program in order to change or 
edit it. The EDIT function is 
selected by the CAPS SHIFT 
key. 


T 


Q W | 


PLOT DRAW 


BEEP When the shift keys are 
used to select the extended 
mode, this key programs the 
command which controls the 
Spectrum's sound synthesizer, 


NEW 


CAPS 7 
CAPS SHIFT This allows SHIFT COPY 
you to select the upper case 
(capital) version of a letter, 
instead of the lower case 
version normally used. It is 
also used with SYMBOL 
SHIFT to obtain the words 
and characters above and 
below the keys. 





Screen display keys The red 
keywords under keys X to M 
produce the commands 
controlling the way the text 
and screen background is 
displayed. The keywords 
INK and PAPER, together 
with the white keyword 
BORDER, are used in 
conjunction with the colour 
keys. 











Cursor controls These four 
keys are used to direct the 
screen cursor to any point in a 
program that needs alteration. 
The cursor function is selected 
by CAPS SHIFT. 


GRAPHICS When used 
with CAPS SHIFT, this key 
switches the Spectrum to the 
graphics mode, ready to 
accept graphics symbols 
from keys 1 to 8, 








DELETE When used with | 
CAPS SHIFT, this key | 
backspaces the cursor and 

deletes keywords and symbols 


on the screen. It also codes for 
the “colour” black. 


PRINT This key carries the 
frequently-used combination 
PRINT“. Pressing this key 
once produces PRINT, while 
pressing it again while pressing 
SYMBOL SHIFT produces 
the double quotation marks. 


BLACK 
DELETE 


i í YELLOW WHITE 


EO INV. VIDEO <> <> м <> 


m 


GRAPHICS 


5 " %7 “! ENTER The Spectrum will 
Е" not respond to most 
commands unless they are 
followed by this key. Itis 
roughly equivalent to the 
typewriter’s carriage return 
key. When the ENTER key is 
pressed, the Spectrum will 
then respond to а command or 
point out any mistakes in 


typing. 


SPACE This is equivalent to 
the typewriter's space bar. It 
also has a second function — to 
BREAK or halt a program 
before it has finished running. 
BREAK is selected by CAPS 
SHIFT. 


BORDER 











How to select key functions 


CAPS 
SHIFT 


Press and hold 





Letter keys When used with the “К” cursor, a letter 
key will produce a keyword. The cursor will then 
change to “L”, and the letter key will then produce 
letters. The keywords above and below the key are 
produced by combinations of the shift keys. 


CAPS 
SHIFT 





Press together then release 


EN um 


Press and hold 








SYMBOL SHIFT The red 


symbol on each key is selected 


by holding this key down 

while the key required is letter key will produce 
prewed.Itmayasobeusedin ` | о ЕЕ 
combination with CAPS $ 1 а. 


SHIFT. 
CAPS CAPS 
SHIFT SHIFT 


Press and hold Press together then release 


Unshifted functions If 
no shift keys are used, a 














Number keys When used with CAPS SHIFT and the 
9 key, these produce keyboard graphics, The keyword 
in red below a number key is produced by a 
combination of shift keys. The red symbol on the key 
is produced by the SYMBOL SHIFT key. 


-一 =] Unshifted functions If 
CAPS SVME CAPS 
SHIFT SHI SHIFT 


no shift keys are used, a 
Press and hold 





a 








YELLOW 


number key will just 
produce numbers, 





ве 





Press and hold 


Press together then release 

















Setting up your Spectrum is quite straightforward and 
logical. Getting the best possible results on the 
television screen sometimes takes a little longer. To 
begin with, connect your Spectrum power supply to the 
mains and link it to the computer. The computer has no 
on/off switch. As soon as you connect it to the power 
supply, you should be able to hear the computer 
humming if the connection has been made. 

Now you need to make a connection between the 
Spectrum and the television so that you can see the 
results of your programming. Take the black lead 
supplied with the computer and plug it into the 
television’s aerial socket. Plug the other end into the 
Spectrum socket marked “ТУ”, and then switch on the 
power to the television. 

The first results that you see will probably look like a 
blizzard, accompanied by a loud hissing coming from 
the television loudspeaker. Turn the television volume 
control down as far as it will go. The Spectrum will 
produce all the sound effects you program with its own 
built-in loudspeaker. Now switch the television to a 
channel that you can allocate permanently to the 
computer. The television treats the Spectrum’s signal 
like any ordinary broadcast, so you have to tune the 
television just as you would to watch a television 
program. Adjust the tuner controls until you see this on 
the screen: 





SPECTRUM SCREEN SIGNAL 


© 1962 Sinclair Research Ltd 


If you cannot get any picture at all from the computer, 
check that all the power connections have been made 
properly. Next, check that the Spectrum's TV socket is 
connected to the television's aerial socket and make 
sure that the channel you are tuning is the one selected. 
You should only have to tune your television once. 
After that just selecting the right channel should 
produce a correctly tuned display. 


а 


How to test Ше Spectrum’s colours 











To enable you to test all the Spectrum’s colours, you can 
use this very simple series of commands to see all the 
colours on screen. Having turned the computer on, 
press the following sequence of keys (ENTER. here 
indicates the ENTER key at the right of the keyboard): 


ВІ ENTER 

B2 ENTER 

B3 ENTER 

B4 ENTER 

B5 ENTER 

B6 ENTER 

B7 ENTER 

Every time you press the ENTER key, you should see 
a change in colour in the» border" area around the 
screen. (The techniques used to produce colours are 
explained on pages 34-35). ВІ ENTER should colour 
the screen like this: 


ВІ COLOUR DISPLAY 








When you use this sequence of colour commands to 
change the colour of the screen, you may find that they 
seem to have no effect. The tuning required to pick up 
the Spectrum's colour signal precisely is quite delicate, 
and you will need to experiment for a while to get the 
best results. If you do get a picture, but then if you 
cannot produce colour on the television, there is a 
possibility that your television is not able to interpret 
the Spectrum's colour signals. Your dealer should be 
able to advise you if this is the case. 

Although the Spectrum's output is normally viewed 
on an ordinary television receiver, the signal can be fed 
into another type of television set known as a monitor. 
This contains everything that your television receiver 
has except a tuner, so it cannot receive television 
broadcasts. Changing the Spectrum's stream of data to 























a high-frequency television signal and then reversing 
the process inside the television reduces the picture 
quality. By eliminating these stages, a monitor is able to 
produce better quality pictures. The screen photographs 
in this book were taken using a monitor, so your own 
television may produce slightly less clear displays. 


Connecting peripherals 
The next connection you will want to make is to a tape 
cassette recorder. The method for using a tape recorder 


to save your programs is covered in detail on page 60. If 


you do want to use the cassette recorder, make sure that 
you have the connecting lead. This is a two-core flex 























which is coloured black and grey. It is very important 
that you do not cross-connect this, or the cassette 
storage and playback will not work. 

Later, you may wish to add a printer to your system. 
The Sinclair ZX printer is supplied with a short cable 
terminated by a plug which clamps onto the edge 
connector in the Spectrum’s rear panel. It cannot be 
fitted the wrong way round. Microdrive units are fitted 
through an interface which sits underneath the 
computer, again linking up with the edge connector. 

When you are using the edge connector, don’t force 
a plug in if you feel any resistance. You may be pushing 
the plug in wrongly, and this could cause damage. 

А 
Arranging the computer To make using 
the computer as comfortable as possible, 
the television screen should be lined up 
behind the computer so that both can be 
seen without turning your head. The 
screen should not be too close. 

Cassettes used for program storage 
should be kept away from the power 
supply, computer and television. 
Recorded programs may otherwise be 
disrupted by the magnetic fields 
produced by these pieces of equipment. 



































Having set up your Spectrum, you may already have 
given in to the temptation to tap a few keys and see what 
happens. If not, try it – you can't do any damage. The 
first thing you will notice is that the Sinclair copyright 
line at the bottom of the screen disappears, and is 
replaced by a line of characters. But as you will have 
seen on pages 10-11, exactly which characters appear 
depends not only on which keys you press, but also on 
the combination of keys that you use. 


Starting to PRINT 

To make some sense of this apparently confusing 
situation, disconnect the power for a second or two to 
clear the computer's memory and then press the key 
with PRINT on it (the P key) followed by one of the 
number keys, and then by the key marked ENTER. As 
soon as you press the ENTER key, the number you 
pressed will appear at the top of the screen. You can use 
PRINT to put a series of numbers on the screen: 

PRINT WITH NUMBERS 





PARNOU 


PRINT 23.0958 


If, instead of disconnecting the power, you press the 
key marked CLS (the V key) and then the ENTER key, 
everything that you have PRINTed will disappear. 


What is a variable? 

Now try typing in: 

PRINT x 

followed by the ENTER key. The computer will 


respond to this - or a command to PRINT any other 
letter — by displaying an error report: 


2 Variable not found, 0:1 


This report, one of many that the computer has stored 
in its permanent memory, indicates why it cannot 
follow the instruction that you have just given it: 














PRINT ERROR REPORT 


1. OO 


ow 


MEPPEN 
РЯ 
a 


о 


2 Variable not 





Instead of putting x on the screen, it has been hunting 
in vain for something in its memory, a variable. 
Using the SYMBOL SHIFT key, now type in: 


PRINT “x” 


When you press ENTER, the computer makes the 
correct response — it PRINTS x at the next line. 

You have just discovered that to the computer, x on 
its own and “х” mean two completely different things. 
The computer treats any letter on its own as a variable. 
A variable is simply a label identifying a number stored 
in the computer's memory. To make PRINT x 
comprehensible to the computer, give x a value 
(remember to press the ENTER key after each line): 


LET x=14 
PRINT x 


USING LET AND PRINT 





Gea 
* 4 OO 
900n 
oo 
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Now x is labelling something, the number 14. LET (on 
the L key) is a command which gives a label and a value 
to a slot in the memory. Every time you ask the 
Spectrum to PRINT x, it will display the last value 
keyed in. Because x is always a number, it is called a 
numeric variable. 


How to use strings 

So x is a numeric variable, but “х” is not; furthermore, 
even if you substituted a number for “х”, it would not 
become a numeric variable, unless you removed the 
quotation marks. The computer displays everything 
inside quotation marks exactly as you type it. You can 
use any characters on the keyboard — letters, numbers, 
mathematical symbols and punctuation marks. Type 
these examples on your keyboard. Remember that you 
can use PRINT as many times as you like, as long as you 
press the ENTER key at the end of each command. You 
can pick capitals with CAPS SHIFT and CAPS LOCK: 
PRINT “AGE” 

PRINT “London” 

PRINT “SPECTRUM SCREEN TEST” 








PRINTING STRINGS 


oOrDexmeoesnmtco 


UM SCREEN TEST 


The characters between the quotation marks are called 
a string. In the same way as a number is stored in the 
computer and labelled by a numeric variable, a string is 
stored and labelled by a string variable. String variables 
are again always letters but unlike numeric variables 
they always end in a dollar sign. In the line: 

LET A$=“LONDON” 

A$ is the string variable and LONDON is the string it 


labels. Having typed in the above line on the keyboard, 
clear the screen with CLS and then type: 


PRINT AS 


After you press the ENTER key, the computer will 
reveal the contents of the string variable typed in. 











Positioning type with TAB and AT 

Now try a different sort of PRINT command, this time 
with a sequence of strings: 

PRINT “Опе”, “Two”, “Three”, “Four”, “Five”, 
“Six”, “Seven”, “Eight” 

You will find that after you press ENTER the words are 
PRINTed in two columns. In fact, the screen is divided 
into two invisible fields, each 16 characters wide. “Опе” 
is PRINTed in the first field, “Two” in the next field, 
“Three” back in the first field, and so on. 

However, two further commands, TAB (on the P 
key) and AT (on the I key), allow you to PRINT 
characters or strings at any position on the screen. Clear 
the screen with CLS and then type these two lines (you 
will need to type out everything between the quotation 
marks in full using letters): 


PRINT TAB 10;“ТАВ EXAMPLE” 
PRINT AT 12,10;"x This is AT 12,10” 


If you press ENTER after each line, your screen should 
look like this: 





USING TAB AND AT 


TAB EXAMPLE 


Хх This is AT 12, 


This shows how TAB and AT position the text. TAB is 
used like the tab setting on a typewriter to PRINT at 
any position on a line. The number that follows it is the 
character position. There are 32 positions on a line - the 
'TAB positions for them are numbered from 0 to 31, 
working from the left. 

AT works like TAB, but it allows you to specify a 
vertical position as well, so you can PRINT at any point 
on the screen. AT is always used with a pair of numbers 
separated by a comma. The first number is the line 
number, working downwards from the top of the screen. 
There are 22 lines on the screen, numbered from 0 to 
21. The second number is the character position, which 
works just like the number used with TAB. Always 
remember the comma when typing an AT command, 
otherwise the computer will not understand it. 




















The PRINT HERE is not limited just to displaying. 
characters on the screen. You can also use it in 
conjunction with the four mathematical functions — 
addition, subtraction, multiplication and division — to 
perform calculations that you can follow on your 
television set. 

Let's take addition first. The plus sign is on the K 
key, the second along from the EN'TER key. Because it 
is the red symbol on the key-top, the SYMBOL SHIFT 
key must be pressed with the plus key to select the 
required character. To add two numbers together, 
simply use PRINT followed by the calculation. 
Subtraction is carried out in the same way. The minus 
sign, which doubles as a hyphen when used in text, is on 
the J key. Like the plus sign, it is also a shifted 
character. Here are some examples, together with the 
results they produce. Remember to press the ENTER 
key at the end of each line to make the computer carry 
out the calculation: 


PRINT 6--18 
PRINT 250--16.5 
PRINT 1.999+6 
PRINT 9054-139 
PRINT 539.7—19.4 
PRINT 1842-655 
PRINT 4.688—4.666 





ADDING AND SUBTRACTING 


PRINT 4.600-4.666WM 


Multiplication is carried out, not with the familiar X, 
but with an asterisk, ж. The asterisk is the red 
SYMBOL SHIFT character on the B key on the bottom 
row of the keyboard. Division uses the oblique stroke, 
/, a SYMBOL SHIFT character on the V key. In 24/8, 
for instance, the left-hand number is divided by the 
right-hand one. To key in the first of the following 
examples, press PRINT 3x6 and then ENTER: 











PRINT 3x6 
PRINT 14»9 
PRINT 2.5*18 
PRINT 5*78 
PRINT 24/8 
PRINT 366/3 
PRINT 600/15 
PRINT 100/0.01 





MULTIPLYING AND DIVIDING 


PRINT 100/70.015 





Exponents and square roots 

In addition to these familiar maths functions, you can 
raise one number to the power of another, (called 
exponentiation). The keyboard cannot produce 
superscripts like the 3 in 27, so instead you have to use 
the up arrow (|) symbol. 2? is calculated by PRINT 
2 1 3. Here are some examples of the up arrow in use: 


EXPONENTS 


e*OOGRBODCOS 
Ope ызы 
iD о 

о 


PRINT 21150 























The computer also allows you to find out the square root 
of a number. The command for this is SQR, the green 
function on the H key. SQR is used like this: 


PRINT SQR 2 


When you press ENTER after keying in this line, the 
computer will PRINT out the answer. However, if you 
try this command with a minus number, the computer 
will produce an error report to let you know that you 
have asked for a mathematical impossibility. 


Getting the order right 

You can carry out a number of different calculations 
using the same PRINT command. Try it with addition 
and subtraction first: 


PRINT 2+6+3+7-8+3-4 

PRINT 48-42+16-2 

PRINT 122-19+32+2.5 

PRINT 4.8+2.8+1.9 

PRINT 1024--14-23 

PRINT 15.5—12.5--7.6—3.8 

PRINT 56—54--8--34—2-- 344-92 — 1004-3 


MULTIPLE CALCULATIONS 


9 
2 
1 
9. 
1 
6. 


PRINT 56-54 +# + 24 -2 + За + 9а -100 + Зй 





You can enter the figures for each calculation in any 
order at all, and the result will be the same. However, 
when you add multiplication and division to the chain 
of calculations, apparently odd things may happen. 
Look at the next list of examples, and try the 
calculations for yourself. Say you want to add two 
numbers together and divide the result by 2. The order 
in which the numbers are added should not make any 
difference to the result, but it appears to do so. Each of 
these lines PRINTs a calculation and result: 


PRINT “3--4/2-”;3--4/2 
PRINT “4--3/2-”;4--3/2 
PRINT “(3+4)/2=”;(3+4)/2 
PRINT “(4+3)/2=”5(44-3)/2 











CHANGING A CALCULATION SEQUENCE 








If 3+4 is exactly the same as 4+3, then why should the 
subsequent division by 2 make any difference? The 
reason is that the computer does not necessarily carry 
out calculations in the order in which you PRINT 
them on the screen. It performs exponentiation first, 
then multiplication and division, and finally addition 
and subtraction, always working from left to right. So 
in PRINT 3+4/2, 4 is divided by 2 before 3 is added. In 
PRINT 4+3/2, 3 is divided by 2 before 4 is added. 
The problem you set the computer was to add two 
numbers together and then divide the result by 2. 
Neither of these examples does that. But you can 
change the order in which the computer performs 
calculations by enclosing parts of the calculation inside 
a pair of round brackets, as in the last two examples on 
the screen. Here, the addition within the brackets is 
carried out first and then the result is divided by 2. 


Knowing your limitations 

There are limits to the numbers that the Spectrum can 
handle and these limits take two forms — size and 
accuracy. Тһе size limitation is unlikely to 
inconvenience you. Positive numbers can have any 
value from 4x107” (4 divided by 1 followed by 39 
noughts) to about 108 (1 followed by 38 noughts). The 
Spectrum stores these numbers to an accuracy of 9 or 10 
figures. The computer memorizes just the first nine 
digits — the rest it sets at zero. 

You may come across another of the computer's 
quirks when dealing with very big numbers. The 
Spectrum does not display them in the way in which 
you type them on the keyboard. For example, PRINT 
2000000000000 produces 2Е12 on the screen (the E 
stands for exponent). This is simply a shorthand way of 
displaying 2x10" or 2 followed by 12 zeros, the 
number you keyed in. Try entering PRINT 10, PRINT 
100, PRINT 1000 and so on and see how the computer 
deals with increasingly big numbers. 

















WRITING YOUR FIRST PROGRAM 


So far you have given your Spectrum commands to 
which it has responded immediately. These commands 
have been very simple — in many cases it would have 
been quicker not to have used the computer at all. 
However, commands on their own are not computer 
programs. The computer reads each command, carries 
it out and then forgets it. A program on the other hand 
is an orderly list of instructions which the computer can 
store in its memory. It can carry them out as and when 
you wish, and as many times as you want. 


From commands to lines 
Having found a task that you want your Spectrum to 
carry out, the next job is to write the program in steps 
that the computer can understand. The Spectrum, like 
most personal computers, uses a computer language 
called BASIC (Beginners’ All-purpose Symbolic 
Instruction Code). BASIC is an example of a high-level 
language, a language composed of words and symbols 
with which you, the user, are already familiar. It is, 
therefore, an easy programming language to learn. 
The commands you key into your computer can be 
turned into programs by adding line numbers: 
USING LINE NUMBERS 





20 LET a®="LONDON" 
$O»PRINT аф 


As you key the program in, you will notice that the 
commands are not now carried out as soon as you press 
the ENTER key, but instead remain displayed on the 
screen. Now that the program is safely stored in the 
computer's memory, it only remains to run it and see 
what it does. Do that by pressing RUN then ENTER. 

You may be wondering why the lines are numbered 
10, 20 and not 1, 2. When you are writing and testing 
programs, you will frequently want to add extra lines. If 
the existing lines are numbered 1, 2, 3, 4, and so on, 
there is nowhere to put the new lines in sequence. In the 
above program, there is room to add extra lines 





numbered 0-9 and 11-19, if necessary. 

The program is still in memory, so to try the next 
one, switch off the power for a second or two to reset the 
computer and erase the old program. Then see what the 
following produces when you RUN it: 


SCREEN DEMONSTRATION PROGRAM 





кою» 
6600 


і “OEMONSTRAT ION 
‘SCREEN DISPL 


ч :апа 
о 906 


Taking it from the top, what is a REM? REM is short 
for REMark. It's a useful device for titling or labelling 
parts of programs, so that you can find them again 
quickly. As your programming ability grows, you will 
find REM lines very useful for reminding you how a 
particular program works. Other people will also be 
able to follow your programs more easily if there are 
periodical REM statements to explain what you are 
doing. The computer doesn't do anything with a REM 
statement other than store it in memory. 

CLS you have come across already. It's a quick way 
of taking all the old unwanted information off the 
screen. Using PRINT on its own (line 30) may at first 
scem a little crazy. PRINT tells the computer to send 
whatever follows it to the screen and move on to the 
beginning of the next line on the screen. If nothing 
follows PRINT, it just moves to the next line. Here, it 
is used to move the line of hypens down. 


How to correct mistakes 

It is easy to make mistakes on the keyboard which 
prevent the program from working. The Spectrum will 
not allow you to ENTER a line that contains a mistake 
in BASIC, but this doesn't stop you writing a program 
with correct lines that produces the wrong result. If you 
do notice a line that needs changing, there is no need to 
retype the program. The computer always uses the last 
version of any line, so to make a change, simply retype 
the line at the end of the program, press ENTER and 
the computer will insert it in the correct place. 





| %, 


CONVERSIONS DISPLAY 


Why punctuation is important 

The next program uses the techniques demonstrated on 
pages 16-17. Switch off the power again for a second or 
two before keying it in: 


CALCULATIONS PROGRAM 





In each of the three calculations, the screen first shows 
what the calculation is (everything within the quotation 
marks is displayed exactly as it is written), and then the 
computer carries out the calculation itself and shows the 
result on the same line. The semi-colon is very 
important. It ensures that the result is shown on the 
same line as, and immediately following, the details of 
the calculation. Try the same program with a comma, a 
colon and nothing at all instead of the semi-colon. 
You'll quickly realize how important punctuation is in 
computer programming. Correct spacing is also vital if 
you want to produce a readable display when the 
computer PRINTs numbers and strings following each 
other. The following program, which again combines 
some calculations with PRINT, shows spaces within 
strings and how they appear when the program is RUN: 


CONVERSIONS PROGRAM 





“CONVERSIONS” 


22 


33,35 33,353 


“1 foot="; 12+2.54; 
"1 gatlone";871.76;" 


,"10 Кі опет гез н"; 19245 


“а аау="; 24 +60 +60; " s 














CONVERSIONS 


1 foot=30.48 centimetres 
1 galtone4.S454545 titres 
10 Kilometres#6.25 mites 
1 day=86400 seconds 





How to write a flowchart 

If a program is to RUN properly, it must carry out the 
correct operations in the right order. Drawing a 
flowchart is a useful way of outlining the steps involved 
in making the computer perform a task. This flowchart 
shows how to plan a program to add up all the numbers 
from 1 to 1000. Each shape is a separate operation, and 
the arrows connecting the shapes show the path that the 
program is to follow. NUMBER and TOTAL represent 
figures that can be entered in a program as numeric 
variables — n and t. This program contains two features 
which you will encounter later — a program “оор” and 
a program “decision point". 


This chart shows all the steps 
needed to program a computer 
to add together all the numbers 
from 1 to 1000. 


Key 
"Terminator Signals beginning 
and end of flowchart 


ВВ еко ыа 


Instruction Identifies each 
separate operation 









LET NUMBER=0 
LET TOTAL=0 


LET NUMBER-NUMBER *1 


LET TOTAL-TOTAL 


IS NUMBER 1000? 









Decision point Instructs 
computer to make a decision 


PES sid 


Input/Output Instructs 
computer to take in or give 
out information 














As you start writing programs, you will often want to 
refer back to check on something or perhaps alter it in 
some way. In order to do that, you must be able to see 
the program on the screen again after it has been RUN. 
The Spectrum allows you look at anything you have 
stored in its memory. In this case, you want to look at 
the “program listing” — the program as you typed it in. 
If you've just switched the computer on again after a 
short break, type in a program from a previous page. 
The BASIC word (or keyword) LIST will call up your 
program onto the screen again from the part of the 
memory where it is currently stored. Every time you 
press LIST the program will be displayed once more: 


LISTING A PROGRAM 





LET Sse" омос 
PRINT за 

LET аве 

PRINT s 


LONDON 


You haven’t transferred the program from one part of the 
memory to the screen — it’s still held in memory. You 
are now looking at a copy of it. If you want to make sure 
of that, use CLS again to clear the screen. If you now 
press LIST, the program will then reappear. You can do 
this as often as you like and the program will remain 
safely in memory unless you disconnect the computer. 


Moving around a LIST 
You will notice that when a program has been LISTed, 
it is displayed in an indented form, with the lines 
beginning two characters further to the right than they 
would if you had just keyed them in. Most of the 
programs in this book are shown in their LISTed form. 
LIST is very useful for developing a program. All 
you have to do to see your program after RUNning is to 
type in LIST followed by the ENTER key. But LIST’s 
capabilities do not end with producing a whole program 
for you to examine. If you key in the next program, you 
will be able to see how to use LIST more selectively. 
The program also demonstrates a technique which you 
will soon be using: 














OPERATOR PROGRAM - 


зе CLS 

20 INPUT “What із your паме"; п 

39 PRINT "$**95»9**»"***55*555 
2271222 ХЫ 

40 PRINT “ZX Spectrum programm 


d by “jns 
SO PRINT "25554449 
Аға к HEE” 


(Incidentally, if you do RUN this program, press the 
ENTER key after you type in your name). Now if you 
want to display the whole program listing, type LIST. 
But you might only need to see a few lines from the end 
of a long program. Using the above program as an 
example, press LIST 30. Only lines 30 to the end of the 
program appear the second time: 


PARTIALLY LISTED PROGRAM 





20 CLS 
20 INPUT “Wheat i$ your паме“;п 


LI 

30 PRINT "s*595*-3J**«**9*9* 
ВЕКАМ 
"40 PRINT "ZX Spectrum programm 


bu ine 
SO PRINT "ежевика REE EE EE 
ЭУ 

SO PRINT “хх 59 99 496%%»:% 
зат вина" 
40 PRINT “ZX Spectrum programm 


by ‚пФ 
БӨ PRINT "ss*9?^4*"94*22222422225 
ROKR REE EE” 


ed 


ed 


How to enter a new program 
Imagine you are starting a new program. Clear the 
screen and type in the first line: 


10 PRINT “SPACE PROBE PROGRAM” 


and RUN it. Something odd happens. The old program 
is still in memory. The computer PRINTS your new line 
10, but then goes on to RUN the remainder of old 
program, because you haven't erased it: 


























COMBINED OLD AND NEW DISPLAYS 





Up to now you have been switching off the power for a 
second or two before entering a new program, but there 
are better ways of getting rid of old programs. One of 
them is to use the BASIC keyword NEW. Press NEW 
and the ENTER key, then key in the new line 10. This 
time the old program will have gone for good. 





RUNning a program segment 

Programs may be RUN starting at any line number you 
like. Often you may have trouble getting part of a 
program to RUN properly. Ina short program, it’s just 
as convenient to RUN the whole program as it is to 
RUN only a part of it. But what if the troublesome part 
that you want to experiment with and RUN over and 
over again comes near the end of a long program? It 
soon becomes tiresome and time-wasting to have to 
watch the first five minutes or so of the program unfold 
before the suspect part comes up. Fortunately, you can 
jump part of a program by using RUN and a line 
number: 


PARTIALLY RUN PROGRAM 





“What із your паме"; п 


* 
9 со 


Ak DU но 
*0ow*»0:242 zr 
dock dM HEH То 


T NHEHARROH REESE RRR аа 
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T "ZX Spectrum Programm 
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ж **0 $40 Пе 
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*X** Q ж 
«7» 
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e 
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z 
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med bu David 
ничья 























In this screen, the “operator” program from the 
opposite page has been LISTed and then followed by 
RUN 30 (produced by pressing RUN and 30 then the 
ENTER key). The result is that the computer goes 
straight to line 30, and then continues through the 
program as before. If you have already RUN the 
program, n$ will have a value — your name — and the 
computer will PRINT this out, although lines 10 and 20 
will be ignored. 

You can get exactly the same effect with the keyword 
GOTO. GOTO is one of the simplest and most useful 
commands in the BASIC language. Used without a 
program line in front of it, GOTO makes the computer 
go straight to a specified line and then RUN a program 
from that point. But when GOTO is actually part of a 
program, the results become very interesting. You can 
get an idea of what this command can do simply by 
keying in this simple program: 


10 PRINT “а”; 

20 GOTO 10 

Your screen should fill up with a display like this: 
EE GOTO DISPLAY 4 





жжж 


««Жжжжжжж жж жж жж oe TT 





Жажа кажа жка о 
AO o woo ood жи e ee o o go o o 
MOOR e e e e o e жжжжжже e e + 
жж жжжжже жа жж же жа жж аа а + 
ТЕРРА 
ee x xx кан» 
же ужа 
ee ee ee ee + 
Edo opo oe + ка m 
CEN EEE eo ood 9o SRR P 
ee ee ee к 
SOR Rob OR o OX GR ж жөке 
УЖ deo de de dee ee 


е eee ERR ek eR eee 
п xoxo voee ен oo ooo 
7 SOR e je te же жежежежжаж 
MEIIIIIIIIILIILIITTTTMMM 
Сс RR Re oe oe ee + 
ee ки ква # + 
BOE ox ка как ка ж 
oko oo eoe goo o ка ка ка 
Bobo ox oe seo o eso goce o 
НЖЖ жж ж жж ж oo CR Go m ан 
FREES EERE ERE EE SO 
Sette Oe eK ee ня 
ie hee ee жая я 
ih doom ee ee ee ee 
eb hee ee ee + 
eee ee ee + 
M9 ooo eon eso o mo жжәне» 
MR bee oo oom om SHOE onm 
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If you are puzzled about why this has happened, don't 
worry. We will be returning to GOTO soon after you 
have mastered a few more BASIC keywords. However, 
you will find that it seems difficult to get rid of this 
display. The clue here is the word “scroll?” that appears 
at the bottom of the screen. The computer is asking you 
if you want the characters on the screen to continue to 
"scroll" upwards to fill the screen again because the 
program has not finished RUNning. In fact it has no 
end at all. To clear the screen press the N key. A 
message will then appear: 


Pressing any other key just makes the scrolling 
continue. Once this message has appeared, you can 
then LIST or erase the program with NEW. 




















Computer programming is one pastime in which 
mistakes are unavoidable. Programs very rarely work 
satisfactorily first time, and the longer they are, the 
more difficult it is to get them right. It’s important to 
realize that making mistakes and correcting them is 
often an interesting part of program development. So, 
don’t ignore, hide or gloss over your mistakes — they are 
an invaluable aid to learning how to get things right. 

For instance, in acomputer program you cannot alter 
punctuation without completely changing the sense of 
what you have written. As you saw on page 19, it will 
have drastic results. To the computer, punctuation 
means something very precise, and if you get it wrong, 
a program may not work. 

You can change a line in a program in two ways. 
First, as you have seen, you can simply retype the line. 
The new version automatically replaces the old one in 
the computer’s memory. However, if there is very little 
wrong with a line, especially if it is a long line, it’s a 
waste of time to completely retype it. The alternative 
way of making a change in this case is to use the cursor 
keys to edit on screen. 


Editing on the screen 
Editing involves using the four keys with arrows 
printed above them and the key with EDIT printed 
above it, all on the top row of the keyboard. Here is a 
program that needs editing: 


PROGRAM BEFORE EDITING 








“HEATHROW, LONDON” 
“JFK, NEW YORK“ 

“O'HARE, CHICAGO” 
“CHARLES DE GAULLE, 


To correct line 40 in the program to read: 
40 PRINT “CHARLES DE GAULLE, PARIS” 


you could retype the line. But try using the screen 
editor instead. First, type in the program and RUN it. 
Now LIST the program on the screen. Press the CAPS 
SHIFT key together with the key on the top row of the 








keyboard with a downward-pointing arrow (not the 

exponent key featured on page 16). The > symbol at the 

beginning of the last program line moves to line 10. Use 

the downward arrow to move it to the incorrect line. 

Now press CAPS SHIFT and EDIT (top row). The line 

marked by the > appears at the bottom of the screen: 
PROGRAM DURING EDITING 








LONDON“ 
мб D 


MY қ 
Е, CHICAGO” 
LES ОЕ GAULLE, 


“CHARLES DE GAULLE, 


You can now use the left- and right-pointing arrow keys 
on the top row to move the cursor to the end of the 
section to be deleted, after the word ROME. Now press 
CAPS SHIFT and DELETE (top row) repeatedly until 
ROME disappears. Then simply type in the characters 
that are to replace ROME. Finally press ENTER. It 
sounds complicated, but once you've tried it, it soon 
becomes second nature. 

You will frequently want to add lines to a program 
after you have written the first draft. Perhaps you forgot 
to put CLS at the beginning to start the program off on 
a clear screen. You do not have to edit any line numbers 
to do this. In the above program, for example, you can 
enter the new first line by typing: 


5 CLS 


As the computer executes BASIC instructions in line 
number order, it doesn’t matter that this line was added 
last — it will be carried out first. 


First steps in bug-hunting 

Mistakes in programs are called bugs, and the business 
of getting rid of them, debugging. As you have 
probably discovered, the Spectrum helps a great deal in 
debugging programs by examining what you type in for 
errors in spelling and grammar or syntax. If it finds any, 
it alerts you in two ways. First, if it comes across 
something that doesn’t make sense in a line as you are 
typing it in, it will not let you ENTER the line. Pressing 














ENTER will have no effect, and second, a question 
mark will flash next to the suspect part of the line, 
giving you a chance to correct it. 

However, even if every single line of your program 
makes sense to the computer, the program may not 
RUN properly. You may have inadvertently told the 
computer to do something impossible — to add two 
numbers, A and B, when you haven't given A or B 
values, for instance. It responds to this by displaying an 
error report on the screen. You came across one on page 
14 – “2 Variable not found, 0:1”. In fact, the Spectrum 
can display over 25 different reports. 

Each report begins with a number or letter (0-9 or A- 
R). The report itself is followed by something like 30:1. 
This means that the program has stopped at line 30. 
The “1” indicates that the error is in the first statement 
on the line. (As you'll see later, it is possible to write 
more than one instruction on a single program line). 
Here are some slightly more advanced programs which 
will not work. Try checking the error reports they 
produce on the table that follows them: 


“BUGGED” PROGRAMS | 








200 STEP 10 











These are some error reports that you may encounter when writing 


your first programs. 
Code| Report 
0 OK 
2 | Variable 
not 
found 
4 Out of 
memory 
5 Out of 
screen 
6 |Number 
too big 
A Invalid 
argument 
B Integer 
out of 
range 
D |BREAK- 
CONT 
repeats 
G |Noroom 
forline 
L |BREAK 
into 
program 









































Occurrence 





The “correct” report. The computer has found no 
errors in your program. 


You have programmed the computer to do something 
with a variable without first defining it. This may 
occur if you miss out quotation marks before and 
after a string (see page 14). 





All the available memory has been used up. With the 
48K Spectrum this is unlikely to happen unless you 
try to combine a number of long programs with 
consecutive line numbers. 


Your program has tried to INPUT more thana 
screenful of lines, or has tried to PRINT below the 
bottom line (see pages 15, 24-5). 


A calculation has produced a number bigger than the 
computer's limit of 10" (see page 17). 


Your program has followed a function with an 
"argument" (the number on which the function is to 
operate) which cannot be used ~ for example SQR 
followed by a minus number (see page 17). 


Your program has produced a number that is larger 
than the limit that the computer can use for a certain 
operation. This often occurs with graphics (see 
page 28). 


Appears when N, SPACE or STOP is pressed in 
response to “scroll?” (see page 21). This report also 
appears if BREAK is pressed while the computer 

is doing something other than carrying out a program 
~ for example, LOADing a cassette (sce page 60). 


The computer's memory has been filled, and there is 
no room for the line that you have just tried to 
ENTER. 

Appears when the BREAK key is pressed while a pro- 
gram is RUNning. The line and statement numbers 
which follow the report show the last line to be 
carried out. Pressing CONTINUE will make the 
computer carry on from that point. 

















given the computer a set of instructions and left it to 
carry them out. Each program has had just one 
outcome, which was exactly the same every time the 
program was RUN. But few real programs are like this; 
in a games program for example, the players feed the 
computer with new instructions every time the game 
RUNs. The computer takes in these instructions 
during the course of the game, changing the display in 
response to the input of information. 

Indeed, it is difficult to write a program of any 
complexity without being able to interrupt the program 
while it is RUNning to feed in new information. 

The BASIC word INPUT is intended to deal with 
this situation. It lets you carry on a conversation of sorts 
with the computer — you “talk” to it through the 
keyboard and it “talks” to you through the screen. 

The INPUT command makes the computer 
remember information typed in on the keyboard, and 
gives it a name - а numeric variable if the information is 
a number, or a string variable if the information is in 
string form. The information is then used later in a 
program. Here is an example of INPUT at work: 

USING INPUT 





2 your name?" 
яких 
"ZX Spectrum programm 


“ORES LOG LL ud us LL 


Questions from your computer 
The program instructs the computer to display the 
question “What is your пате?”. Line 30 then stops the 
program, leaving the question PRIN Ted on the screen. 
'The computer is waiting for new information from you. 
"There's no need to hurry — there isn't a time limit. The 
computer will wait forever or until you type in the 
information it needs. Type in your name and press the 
ENTER key. The program continues. 

The INPUT line of the program takes your name and 
labels it with the string variable n$. The dollar sign 


n all the programs you have written so far, you have 





shows that the computer has been programmed to 
expect a string. This program is similar to the one used 
on page 20 as an example of LIST. You can see from 
that earlier program that INPUT can also PRINT: 

| COMBINING INPUT AND PRINT 








“What is your name*';n 
“>>>. 
"ZX Spectrum programm 


"Жек ж KERR REE 
Ағза зы” 


Programming multiple INPUTs 
Many programs use INPUT a number of times to 
gather different items of information. It is quite easy to 
do this. All you have to remember is that you will need 
a separate variable for each INPUT. Once you have 
given the computer the information that each variable 
will label, it can then use the variables in a program. 

In the previous program, n$ was used to label a string 
— in that case it was a name. But a string doesn't have to 
be just letters, it can be numbers. If you label a number 
as a string, the computer will deal with it as a string. 
Here is a program that does this: 

MULTIPLE INPUT PROGRAM 





"Enter name” 


"Enter today’s 


d 


a 
2 
3 
4 
a 
5 
6 
оо 
? 
а 
9 
а 
1 


"Enter time одо 


"ZX Spectrum p 
"by ";n$;" on 


TDsDOH TH знто 
nsurz nz9nzur 


9493686 :60-6669 




















In line 100, the computer PRINTs d$, which is the 
date. If the variable had been just d, the computer 
would have taken the date's oblique lines to mean 
"divide by”. As a string, d$ is left unaltered: 


MULTIPLE INPUT DISPLAY 





ZX Spectrum Programming 
by Peter оп 127107084 


Using INPUT with numbers 

Because you can use INPUT to gather numbers as a 
program is RUN, this command has many practical 
applications. Consider, for example, the problem of 
converting lengths, sizes or weights from one unit of 
measurement into another. The conversion is always 
the same — 2.54 centimetres to the inch, 2.2 Ibs to the 
kilogram, 1.76 pints to the litre, and so on — but the 
numbers in each new calculation are different. Here is 
a simple conversion program for you to try out: 


INPUT CONVERSION PROGRAM 


10 CLS 
aren PRINT 


зае“ PRINT 


AT 5,9; "Conversion pr 


AT 10,0; “How many Pin 


195,0;p;" pintsz'";p 


ат 
Litres 





The program asks you how many pints you want to 
convert to litres, waits for your response, does the 
calculation and then displays the result on the screen. 
Because the INPUT line is expecting a number in 
response to the question it asks, the variable it produces 


ER 











is a numeric one, p. This labels the number you key in^ 
for use later on in the program. 

Next is a program that asks you for two pieces of 
information, and then uses them with the command AT 
to fix a point on the screen: 


USING INPUT WITH AT 


PRINT AT 5,5; “Mapping the s 


"Give me а ro 


"Give me а co 


CLs 
PRINT AT 





If you RUN this program, you will find that it asks you 
for a row and column number and then PRINTS an X at 
the position specified by your co-ordinates. The letters 
r and c are just labels, numeric variables waiting to be 
given values. It is these values that you key in when the 
program is RUN. 

You can shorten this program by making a single line 











with one INPUT statement collect both these figures. 
Type in each number followed by ENTER: 


COLLECTING TWO VARIABLES WITH ONE INPUT 


INT AT 5,5; 


NT RT 10,0;"Give me a ro 
and à column 


"MapPPing the s 


бо PRINT BT eae 





All the spaces between “and” and “a column” may look 
rather strange to you. If you don’t put them in, you’ll 
find that the message PRINTed by line 30 is split 
awkwardly between two lines. The extra spaces bring 
the whole of “а column number (0-31)” down to the 
middle of the next line. 









WRITING PROGRAM LOOPS 


Computers are extremely good at doing lots of simple, 
repetitive jobs very quickly. But if it is to do anything 
involving repetition, the computer must have some 
means of carrying out the same program or part of a 
program repeatedly. There are several ways of writing 
these program “loops”. On page 21 you came across a 
loop using GOTO. Here it is in a slightly more complex 
loop produced by the same method: 


NEVER-ENDING LOOP PROGRAM 





BREAKING INTO A LOOP 











RE QUONAGFONFOOOVAGFONR 
чопропебодфлаолфонпшевова 
соосозобемоврсоснетомлоне 








19 
ге 
зе 
4o 
5o 


г GUURPRRRRRRRRROODUODOUOOD 
е ооромоююмееккьмкенкеккемкео 
= Евбььшпаофьыьбевкоооотов 





BREAK into pros 


Q 





Note that in this loop program, line 50 does not point 
back to the very beginning of the program at line 10. If 
it did, x would always be equal to 1, and the screen 
would clear each time the first line was PRIN Ted. 


How to stop a loop 
The solution to these endless programs is the FOR ... 
NEXT loop. This allows you to set limits on how many 
times the program is carried out. You can adapt the 
GOTO program to use FOR... NEXT instead: 

i ‚.,МЕХТ LOOP PROGRAM 


юмоювекнкьыынекесто-ольСсЮюы 
пебролопропез 
ФРРООУПЮРРе РР ОотРОПРО Ве 


т 
^ 
о 

9 








If you RUN this program, you will quickly see the 
disadvantage of using GOTO alone — the program is 
never-ending. When the screen has filled up with 








figures, "scroll?" appears at the bottom to show you The FOR ... NEXT loop both improves the program 
that the program has not finished yet. and shortens it by one line. Note that you don’t have (0 | 
If you press most keys, the display will continue. But include LET x= or add 1 to x on each loop of the | 
if you do let the loop continue scrolling, there is a way program now, because FOR ... NEXT takes care of it 
that you can later exit from the program. As you saw on automatically. It starts off by setting x equal to 1 and 


page 21, pressing the N key will break the loop. Using PRINTing x and x-squared. Line 40 asks for the next 
BREAK will also do this, producing a line number: value of x and so the program re-starts from line 20, the 














beginning of the FOR ... NEXT loop, and executes the 
intervening lines once more. This continues until x has 
a value of 21, the maximum set by line 20, and in this 
case, the program stops. 

If necessary, the loop can be interrupted on each pass 
through to wait for new information. Try using INPUT 
in the middle of a FOR ... NEXT loop: 


FOR...NEXT WITH INPUT 








T AT 12, 
temperat 
ПА 


Fahrenhei 
ade” 


This program converts Fahrenheit temperatures into 
Centigrade. The FOR ... NEXT loop beginning at line 
10 sets a limit of five calculations, after which you will 
have to RUN the program again. The INPUT 
statement at line 50 stops the program until you type in 
the Fahrenheit temperature you want to convert. Line 
60 then does the calculation and PRINTs the result. 


Slowing a loop down 

One problem you may encounter when writing 
programs is that they often RUN too fast for you to be 
able to follow anything which is PRINTed on the 
screen. Line 70 in the temperature conversion program 
is used to deal with this problem. The command 
PAUSE stops the program temporarily so that the 
result of the conversion stays on screen long enough for 
you to read it before the next run through the loop 
begins and the screen is cleared. The length of this halt 
is set by the number following PAUSE. This number 
represents the length of the PAUSE in fiftieths of a 
second. Hence PAUSE 200 interrupts the program for 
200/50ths or 4 seconds whereas PAUSE 0.5 is just 
1/100th of a second. 


How to round numbers off 

The layout of the conversion display could be 
improved. It's fine as long as the result of the calculation 
is a whole number, but it rarely is. The more figures 
there are after the decimal point, the further 
“Centigrade” is pushed along the line until it splits and 
part of it ends up on the next line: 

















TEMPERATURE CONVERSION DISPLAY (| 


Temperature conversion 


in a Fahrenheit 








Туре 
de, Fahre&enheitz198.32323232323 Centigra 
е 


temperature 


To get around this problem, try replacing (t—32)*5/9 by 
INT ((t—32)*5/9+0.5). INT, short for INTeger, turns 
a decimal number into a whole number. If the result is 
18.333333, for instance, adding INT changes that to 
18. The number is more sensible, and the display looks 
much better: 


ROUNDED-OFF CONVERSION DISPLAY 





Temperature conversion 


Type іп а Fahrenheit temperature 
65 Fahrenheit»165 Centigrade 





When you use INT, remember that it always rounds 
downwards to the next whole number. You may have 
wondered why the INT line has 0.5 before the last 
bracket. This is to ensure that INT always produces the 
nearest whole number. Adding 0.5 will achieve this. If 
you are confused by this, try keying in these two direct 
commands: 


PRINT 3- 1.1 
PRINT INT (3- 1.1) 


The result of the first is 1.9, and the result of the second 
1. But 1.9 is much nearer to 2 than 1. So, to compensate 
for this in the temperature conversion program, 0.5 is 
added before INT is used. 


















The ZX Spectrum’s BASIC includes several commands 

for drawing points and lines on the screen. If you want 

to draw a point or line, you must have some way of 
telling the computer where to start drawing. The screen 
is, therefore, divided up into a grid, made up of tiny 
dots. These dots are called picture elements (usually 
shortened to pixels) because the picture on the screen is 
made up from them. Each pixel is numbered — 0 to 255 
across, and 0 to 175 up and down. The 0,0 position is at 
the bottom left corner of the screen. The co-ordinates of 
a point on the screen are always given as x,y, with x (the 
number of pixels across the screen from the left) first, 
followed by y (the number up from the bottom of the 
screen). On the screen below, each’ grid square is 8 
pixels wide and 8 pixels high: 
— GRAPHICSGRID | 








Unless you tell the Spectrum otherwise, it assumes that 
you want to start drawing from 0,0 (also called the 
"origin") or from the last position visited. You can make 
a point appear on the screen by using the Spectrum's 
PLOT command. To make a black dot appear at the 
centre of the screen, type: 


PLOT 128,88 


You can check these co-ordinates on page 61. 





How to draw lines 


Lines are drawn on the screen using the command 
DRAW. For instance: 


DRAW 128,88 


DRAW sa line from the bottom left corner of the screen, 
the origin, to a point in the middle of the screen. If you 
then instruct the computer to DRAW a second line, it 
will automatically start DRAWing from wherever the 
last line ended. You can use this to your advantage to 


| 






produce simple, straight-line shapes very easily. Here is 
a LISTed program that produces three lines, together 
with the shape it DRAWs: 


MULTIPLE LINE GRAPHICS 


10 CRRU 200,150 
ге DRAW 40, -50 
зе DRAW -240, -100 





Line 10 DRAWsa line from the origin at 0,0 to 200,150. 
The next line is to be DRAWn from 200,150 to 240,100. 
The changes in the x and y co-ordinates are 40 and —50 
respectively, so line 20 is therefore DRAW 40, —50. 
Finally, line 30 DRAWs the third side of the triangle 
from 240,100 back to the origin. 


Picking a starting point 

To DRAW a shape in the middle of the screen, you must 
tell the computer that you want to start DRAWing from 
somewhere other than the origin at 0,0. The PLOT 
command takes care of that. First, PLOT a point where 
you want to begin DRAWing. Now, the next line 
DRAWn will begin from that point: 


A USING DRAW WITH PLOT 













































How to fill in shapes 
It is now a simple matter to fill in these line drawings to 
produce solid black figures: 


SOLID RECTANGLES WITH FOR...NEXT 


FOR x=20 TO 220 
PLOT x,1e00 
DRAW о,-со 

EXT X 


This repeatedly DRAWs lines from the top of the 

rectangle down to the bottom, gradually working from 

left to right, generating a solid black rectangle. A solid 

triangle is produced in a different way. The lines are all 

DRAWn from a single point, one apex of the triangle: 
SOLID TRIANGLES WITH FOR...NEXT 





Now let's try something a little more ambitious. In 
addition to points and lines, the Spectrum can generate 
a number of graphics characters that are permanently 
stored in its memory. You can see them printed on the 
tops of keys | to 8. The largest is a square the size of one 
character, while the others display halves, quarters and 
other fractions of squares. Using these characters is a 
simple way of generating graphics, but it produces only 
coarse images, and, since each character can occupy 
only character positions, only jerky "movements are 
possible when you come on to animation. 

Selecting them involves switching to the graphics 














cursor. For instance, to make a black square type: 
PRINT “m” 


To produce this, before pressing key 8, switch to the 
graphics cursor by pressing CAPS SHIFT and 9. Now, 
holding CAPS SHIFT down, press key 8 to produce the 
character. Before continuing, press CAPS SHIFT and 
9 again to remove the graphics cursor. You can produce 
the inverse (negative) of any keyboard graphic by not 
using CAPS SHIFT again when pressing the symbol 
key. So, to summarize, the sequence of key presses 
needed to produce the black square is: 


CAPS SHIFT and 9 
CAPS SHIFT and 8 
CAPS SHIFT and 9 


DRAWing a simple landscape 

The following program shows you how you can use 
these graphics symbols together with the PLOT and 
DRAW commands to produce a basic landscape: 


USING KEYBOARD GRAPHICS 
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You can make up almost any shape of graphics 
character by using PLOT and DRAW as described on 
pages 28-29. However, it is much more convenient if 
you store your own graphics characters in the 
computer's memory in the same way as it stores all of its 
own keyboard characters. You can then treat a graphic 
symbol - a rocket ship or a human figure — as a single 
character, instead of having to RUN a special program 
to DRAW and PLOT the symbol each time you need it. 
The Spectrum allows you to program the A to U keys 
with any graphics symbols of your choice. 






How to use a character grid 
Say you want to put a small rocket on the screen for a 
space game. The shape will be shown on the screen as a 
pattern of dots on an 8X8 grid, so draw one out on an 
8х8 grid on a piece of paper, as on the diagram below, 
or use the grid on page 61. 

$ Draw the shape by blacking in whole squares. When 
you have done this, add up the numerical values of the 
squares in each row. On the top row of the example, 
only one square, the one with 8 above it, is blacked in, 
so the total for the top row is 8. In the next row, the 
squares labelled 4, 8 and 16 are black, so the total for 
row 2 is 28, and so on. These totals can then be fed into 
the computer to reprogram one of its keys. 

POKE is a command which allows you to put 
information directly into the computer’s memory. 
USR“a” in the following program tells the computer 
that you want to recover your character by pressing the 
“а” key. (Using a capital A would work equally well). 
The number following (+1, +2, etc) identifies which 
row of the 8x8 grid the final number refers to. Eight 
limes of the program are necessary to install the new 
character, working from “а” through to “а”+7. Here is 
the rocket and the program that stores it: 
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DESIGNING YOUR OWN CHARACTERS 














ROCKET PROGRAM 











10 POKE USR "а,ә 

20 POKE USR “a“+2,28 
30 POKE USR "a"«2,62 
40 POKE USR "a”+3 3 
59 POKE. USR "а" 44,28 
60 POKE USR "a"45,285 
70 POKE USR а" +6,62 
60 POKE USR "а" +7,127 





Now you need а way of getting your character back out 
of memory and onto the screen. The PRINT statement 
is used. To PRINT the newly programmed character in 
the middle of the screen add this line to the above 
program, first changing to the graphics cursor, and then 
repeatedly pressing the A key: 


90 PRINT АТ 15,8;“АААААААААААЛА” 


4 ROCKET DISPLAY 


1111111111111 





By switching to the graphics cursor, pressing the A key 
repeatedly, and then removing the graphics cursor 
again as described on page 29, a row of the character you 
have designed is entered in the program line. Then just 
RUN the program. 


How to add characters together 
The first thing you will notice is that the rockets are 
extremely small. Have a try at something larger: 





















Коу | Although user-defined characters are based on an n" 
grid, there's no reason why your character should not 
200 | cover more than one grid. 

Again, key in the totals representing each row in each 
8x8 grid. Each grid must be labelled with a different 
keyboard letter to identify it. In the program that 
follows the new rocket, they are labelled with the letters 
а, $, d, and f. 


Screen patterns with POKE USR 

With user-defined graphics it is possible to use your 
own characters to make a pattern by PRINTing them 
all over the screen. In this program, try filling in the 
zeros in lines 10-80 to define a character (the grid on 
page 61 will help you with this). Instead of giving the 
character a fixed position such as in the above example, 
the program will PRINT the character AT r,c where r 
(the row number) and c (the column number) are 
constantly changing. Here is the program and a display 
made by replacing all the zeros in lines 10-80 with 
195,231,126,36,36,126,231,195: 


PATTERN GENERATOR PROGRAM 
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Once you have learned how to create a character and 

make it appear anywhere on the screen using PRINT 

AT, you can then attempt some simple animation by 

using the same method to make the character move. 

First, you need a program that produces a character: 
STATIC CHARACTER 
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This program creates an “alien” with two graphics 
symbols by reprogramming the Q and R keys. 


"Together, the symbols make up an alien in the middle of 


the screen. Line 170 tells the computer to PRINT the 
top half of the alien AT 11,15, while line 180 uses AT to 
put the bottom half in the right place. 

Now you can try making it move from one side of the 
screen to the other. You will be relieved to know that 
lines 10 to 160 inclusive remain exactly the same, so 
don’t press NEW before making the following changes 
or you will have to type in the whole of the program 
again. There’s no need to delete lines 170 or 180, 
because the new lines will replace them. 











These lines and changes will start the alien moving (the 
graphics symbols will automatically replace Q and R if 
you have RUN the original program): 





ANIMATION LINES 


How to remove after-images and control speed 
When you RUN the modified program, the first thing 
you will notice is that it doesn’t do exactly what you 
want it to. The Spectrum moves the alien from left to 
right, but as it moves the alien, it doesn’t remove the old 
images. The result is a long line of characters: 
DISPLAY WITH AFTER-IMAGES 





The problem is that you haven’t told the computer to 
remove the old unwanted images. Doing that is quite 
easy — just PRINT a blank space after each of the 
characters with these lines: 


205 PRINT AT r,c—1;“ ” 
206 PRINT AT r+1,c—1;“ ” 














The alien now moves from left to right without leaving 
a trail. But it’s very fast. How can you scale down the 
speed? Put in a time delay: 


207 PAUSE 2 


Now the alien takes longer to reach the right side of the 
screen, You can adjust its speed by altering the PAUSE. 
This screen shows an impression of the movement (the 
after-images will not actually appear on your screen): 





ANIMATION WITH DELETIONS 


You will find that the slower the speed, the more clearly 
the alien appears on the screen. Flickering occurs when 
a symbol is moving quickly, or if it is made up of a 
number of characters. With a two-character symbol like 
this, there is a slight time delay between the computer 
PRINTing the first and the second character. If you use 
more than two characters to make up a symbol, the 
flickering as the symbol moves will be more noticeable. 


Movement up and down the screen 

You can move something down the screen from top to 
bottom, or vice versa, equally easily. Instead of varying 
the horizontal position (shown by the changing variable 
cin the alien program), you change the vertical position 
by the same method. 

The next program stores a symbol representing a 
small rocket under the A key, and then makes it fall 
down the screen. The same sort of FOR ... NEXT loop 
as was used in the alien animation is used here at line 
140. (FOR...NEXT and other program loops are 
explained on pages 26-27.) The r (row) variable 
increases so that the rocket is PRIN Ted at progressively 
lower positions. 

To make sure that the rocket does not leave a trail, the 
program PRINTS a blank space behind it. Because this 
program uses a symbol only one character wide, only 
one blank space is needed. To give the rocket something 
to hit, lines 90 to 120 PRINT a simple landscape with a 
horizon, just like on page 29. Line 190, which is only 








carried out after the FOR ... NEXT loop has been 
completed, PRINTs five graphics characters (ones 
found on the number 6 key). This line produces the 
impression of the rocket's impact: 

i ARROWHEAD FALL PROGRAM 
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_ INTRODUCING COLOUR 








The Spectrum's television display is not limited to 
black letters and symbols on a white background. It can 
actually PRINT in any of eight colours (including black 
and white) and you can insert these colours in your 
programs. Each colour is identified by a number. 

If you look at the number keys, you will see that keys 
| 1-7 and 0 have a colour printed above them. To pro- 
duce a colour on the screen, you need to use one of 
these colour codes together with a colour command. 


Using colour commands 
The Spectrum has three ways in which you can control 
colour. INK (on the X key) controls the colour of text 
РКПУ Тед on the screen. PAPER (on the C key) selects 
the colour of the background, and BORDER (on the B 
key) controls the colour around the edge of the screen. 
To select a colour, you just have to key in one of these 
commands followed by a colour number. 

'To see what colours INK produces, key in this colour 
chart program: 

INK COLOUR CHART PROGRAM 
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Lines 20 to 70 contain a FOR ... NEXT loop which 
PRINTs a row of graphics characters (on the number 
keys) in each of the INK colours from 1 to 7. The 
program PRINTS all the colours except black: 





E i SPECTRUM COLOUR NUMBERS | 
Each colour command is followed by one colour number. 


. . Number _ Colour 
0 Black 

















6 Yellow 


7 White | 

















INK COLOUR CHART 


па ЕЕ ЕЕ па па па па па па | 
1 ша . а зә X4 2а ша за да GG UEM (£d UND XN x 
ЗА С В Ш ее ре етер т Се 
SAR SSeS ese ese 


Line 10 makes the PAPER and BORDER areas turn 
black. You will notice that the line contains the 
command CLS. This is to ensure that the PAPER area 
is black before any text is PRINTed. Normally, the 
PAPER command only produces a coloured 
background immediately behind each PRINTed 
character. To colour the whole PAPER area, you must 
follow the PAPER command with CLS. 


Changing INK, PAPER and BORDER 

The next step is to see what happens when you use 
different INKs together with changing PAPER and 
BORDER commands. The following program does 
just this; it contains three FOR ... NEXT loops, one to 
control each of the colour commands. If you RUN it, 
you will see all the possible combinations of INK, 
PAPER and BORDER (there are 512 altogether!): 

BORDER/PAPER/INK DEMONSTRATION PROGRAM 
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BORDER/PAPER/INK DEMONSTRATION DISPLAYS 





These two displays are produced by keying in the 
demonstration program. When you are writing your 
own program listings, you can work with any INK, 
PAPER and BORDER colours just by keying a line in 
(without a line number) before you start your listing. 
White on black, which produces an easy-to-read 
display, can be produced by keying in: 


INK 7:PAPER 0:BORDER 0:CLS 


Pressing NEW will reset the computer. 


Improving the picture 
If you are disappointed with the television picture your 
Spectrum is producing, you may be able to improve it 
by going through some simple checks. Make sure that 
the television is properly tuned into the computer’s 
output signal. The tuning setting of both may drift from 
time to time, so it is a good idea to check your television 
tuning periodically. 

If the picture is covered by a herringbone pattern, 
and you have checked that the television is properly 























tuned, make sure that there is nothing nearby that 
might be interfering with the computer's signal — a 
video recorder or another television set for example. 
Finally, the more colourful and brilliant a picture is, the 
more distorted it will seem to be. Try reducing colour, 
brightness or contrast to improve this. 


Colouring user-defined characters 
If you define your own character with POKE USR (as 
on pages 30-31) you can PRINT this in any INK 
colour. Here is a program which produces a character — 
a pair of small stars — and which PRINTS it all over the 
screen in INK colours from 1 to 7: 

| COLOUR STARS PROGRAM 
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Experimenting with colour is simple. When you 
become more adept at it you can begin to create new 
colours by optical effects. For instance make up user- 
defined characters from a grid of dots of which every 
other dot is a second foreground colour. Now, colour 
the background in a contrasting colour. Red dots on a 
blue background for example will mix to appear purple, 
while red and yellow will appear orange. 
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Colour can be added to Spectrum graphics using the 
same commands and techniques as are used to colour 
text and user-defined characters. You don’t need to 
learn special commands, nor to write a long program to 
produce simple colour graphics. Here, for example, is 
the arrowhead fall program that you used for animation 
on page 33. If you type in the program again, you can 
then add some colour to it: 


ARROWHEAD FALL PROGRAM 
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Programming graphics colour 
Now key in an extra line to the program: 


85 BORDER 2:PAPER 1:INK 4:CLS 


If you look at the colour codes on page 34, you should 
be able to tell what effect the new line will have. Now 
RUN the program. Here is the adapted listing 
containing the new line: 
|. — COLOUR ARROWHEAD FALL PROGRAM | 
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You should find that the adapted program now 
produces a red arrowhead, a blue sky, green ground and 
red BORDER. When the arrowhead reaches the 
ground, the graphics characters that show the impact 
are now PRIN Ted in green against blue — because line 
190 is also affected by the INK and PAPER commands 
in line 85. Here is the coloured display that the adapted 
program produces after the arrowhead has completed 
its fall from the top of the PAPER area: 

COLOUR ARROWHEAD FALL DISPLAY 








Animated action in colour 

You now have the basic expertise needed to write an 
animated colour graphics program. As an example of 
some simple colour graphics, here is a program which 
brings together everything that you have learned so far. 
It is built up from a number of separate blocks or | 
"modules", most of which you should be able to follow: 


LASER ATTACK PROGRAM 





10 DATA 2,244,46,21,21,45,244, 
20 DATA 6,16,50,254,254,55,16, 
зо DATA 146,04,04,254,124,254, 
124,254 
49 FOR п-9 TO 7; READ x 
БӨ POKE USR "а" +п,х 
60 NEXT n 
FOR пәс TO 7 READ x 
POKE USR “5 +п , х 
NEXT n 
FOR nsO TO 7 RERD x 
POKE USR "d'"sn,.x 
NEXT n 
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LASER ATTACK PROGRAM 


NT INK г; ят 15,4;"M' 
с-а 


поп 


0 TO ге 
RT г,е;“ 

0.08, 
HT 


, "Жы 
2 ВЕЕР o.02,12 


o2,8 


m 
XnÁBman-s 
449272 


Е 
о. 


0207071г7 


nmmmomomonn CARD 


40,56 DRAW INK 7 28, 





DZrgugugTnoG 


You will probably be puzzled by lines 10 to 30. These 
lines are actually part of a quick way of producing user- 
defined characters. If each of the a, s and d keys were 
reprogrammed by the method we've been using up to 
now, it would take 24 lines - 8 lines of POKE USR 
statements for each letter. Using this new method, each 
key can be reprogrammed in a maximum of four lines, 
with a list of grid totals stored after each DATA 
command. The program uses three characters; two to 
make the front and back of a rocket, and another one to 
make a laser base. 

The READ...DATA routine, explained on pages 
50-53, is a quick method of assembling all the data you 
need to make up user-defined graphics. It enables you 
to put all the data into one statement, instead of using 
the POKE USR routine line by line. 

Lines 40 to 120 then take the information that is 
stored in lines 10 to 30, and turn it into the characters 
themselves. The green ground is produced by lines 
140-180, which contain a double FOR ... NEXT loop 
that repeatedly PRINTS a green square across the 
bottom of the screen. Line 190 then PRINTS the laser 
base. 

Lines 200 to 260 control the movement of the rocket, 
sending it across the screen at a fixed height. You can 
see it on the top screen of the three in the right-hand 
column. You probably will not need to be told that the 
BEEP command produces the sound of the rocket. 
(You will shortly be coming on to using this command 
both for sound effects and notes). 

Lines 270 to 300 program the laser to fire by 
DRAWing a line that hits the rocket (see the centre 
screen on the right). Once this has happened, lines 300 
to 370 send the rocket plunging to the ground, while the 
final line PRINTS its crumpled wreckage. (In the final 
screen on the right the rocket is shown without the 
deletions which actually occur). 

When you type in this program, remember that all 











the graphics symbols are obtained by switching to the 
graphics cursor (CAPS SHIFT +9) and pressing the 
appropriate user defined key - a, s or d. Remember also 
to remove the graphics cursor again before continuing. 





LASER ATTACK DISPLAYS 

















As you saw on pages 32-33, it is possible to animate 
characters simply by PRINTing, erasing and 
rePRINTing the characters in a new position. If you 
want to take animation displays a step further, you can 
make use of two new Spectrum keywords INVERSE 
and OVER. These allow you to produce animation 
when the ordinary PRINTing technique will not work. 

INVERSE is a command which switches over the 
INK and PAPER dot pattern on the screen, to give an 
effect which looks like the negative of a character. 
OVER lets you PRINT one character over another, so 
that the normal erasing that happens when you 
overPRINT does not take place. 

INVERSE and OVER can be used to PRINT, PLOT 
or DRAW something over a background that itself has 
something DRAWn or PRIN Ted on it. This program 
shows what happens if you try to animate over a 
background without using these commands. It DRAWs 
a laser beam which fires across a grid: 

LASER AND GRID PROGRAM 
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Lines 10 to 50 DRAW the grid — a black grid on a white 
background with a blue BORDER. Lines 60 and 70 
PRINT a blue laser base in the bottom left corner of the 
screen. Line 80 PLOTS a point at the middle of the top 
of the laser base. This is simply a way of moving the 
graphics cursor to the top of the laser base, to the point 
where the laser beam will fire from. Line 90 produces 
values for x and y, which are the co-ordinates of the 
point to which the laser will fire — the end of the beam. 
The co-ordinates are set at random by the command 
RND (you will full details how to use this new on pages 
48-49). 

Line 100 DRAWs the black beam to x,y, while line 
120 then “unDRAWs” the beam by DRAWing it in the 
background colour — white. Line 80 returns the 
program to the beginning of the firing routine again. 





The next two screens show the display as it is when 
the program starts, and then as it is after the program 
has RUN for a while: 


LASER AND GRID DISPLAYS 

















UnDRAWing and overPRINTing 
You can see from the second display that the program 
doesn't do what is wanted. Firstly, when the beam is 
unDRAWA, the parts of the grid that lie along its path 
are also unDRAWn with it. Secondly, and perhaps 
more surprisingly, when each beam appears, so do the 
parts of all the previous beams that pass through 
character positions occupied by the current beam. 
You could make the old beams invisible by adding 
INVERSE 1 to lines 100 and 110 like this: 


100 DRAW INVERSE 1; INK 0;х,у 
110 DRAW INVERSE 1; INK 0;—x,—y 


'The problem now is that, although the images of old 
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beams are eliminated, so is the current beam. 
Moreover, white squares still appear along the path of 
the beam, erasing parts of the black grid. You could try 
this instead: 


100 DRAW INK 0;x,y 
110 DRAW INVERSE 1;-х,-у 


Now the beam will work properly, although its end 
point remains on the screen when the rest of the beam 
has been erased. The grid appears to be cut by white 
lines where the beam passes through it. The answer is to 
use OVER instead. Change lines 100 and 110 to: 


100 DRAW OVER LINK 03x,y 
110 DRAW OVER 1;-х,-у 


Now the beam works properly: it appears against the 
background of the grid and disappears again, without 
leaving any white cuts across the grid to mark its path. 
However, the end point of each beam remains on the 
screen. If this should fall on one of the grid lines, it 
leaves a white dot, breaking the line. This happens 
because even though the beam is DRAWn along one 
path and unDRAW/n back down the same path back to 
its start point, the computer doesn't follow exactly the 
same path in both directions. So, to solve that, DRAW 
and unDRAW the beam along precisely the same path: 


110 PLOT 16,16: DRAW OVER 1;х,у 


Each beam is now DRAWn and unDRAWn from the 
same start point (16,16) to the same end point (x,y). 
The end points now no longer remain on the screen. 
The program works perfectly. The beams repeatedly 
flash across the grid and disappear again, leaving no 
evidence that they’d ever been there. 


OverPRINTing with graphics 
Now you can try replacing the laser beam with a larger 
graphics symbol, moving across a detailed background: 
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Lines 20 to 50 PRINT a green ground on a blue < 
background, which forms a blue sky. Lines 60 to 90 
DRAW a series of black perspective lines on the green 
ground to help give the impression of depth. Lines 100 
to 130 DRAW a series of yellow lines across the sky. 
Line 110 controls their spacing as they are DRAWn 
upwards on the screen. Lines 140 to the end of the 
program PRINT a small aircraft on the ground and 
then make it take off and fly up and out of the top of the 
screen. Using OVER, the background is left 
untouched. The moving symbol has no effect on the 
lines previously DRAWn: 


OVER GRAPHICS DISPLAY 
























































To get some experience of using INVERSE and OVER, 
try changing the colours in these programs, and 
substituting PAPER colours for INK colours and vice 
versa. Testing these commands in short programs will 
soon give you ideas for using them in graphics. 

When you do use INVERSE or OVER, remember 
that they are commands which must be activated or de- 
activated by the number that follows them. On their 
own they will not work. 







How to BRIGH Ten up your displays 

As well as producing displays in seven different “real” 
colours, the Spectrum can produce displays of different 
colour intensities. The command used to change 
brightness is simply BRIGHT. This is used in PRINT 
statements in the same way as INVERSE and OVER. 
To turn on extra brightness, you use BRIGHT 1, and to 
turn it off, you use BRIGHT 0. If you type in these lines: 


10 BORDER 0:PAPER 0:CLS 
20 PRINT “without BRIGHT” 
30 PRINT BRIGHT 1;*with BRIGHT” 


you will be able to see the difference that this command 
makes. You can also use BRIGHT 8. This enables you 
to PRINT BRIGHT text without altering the original 
PAPER colour in the position to be PRINTed on. 
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_ SPECIAL SCREEN ТЕСНМІ 


Many programs rely for part of their effect on 
characters that flash on and off. With the Spectrum, 
you could make characters appear to flash by rapidly 
changing the INK and PAPER colours. But don't rush 
to your keyboard to try this, because there is a much 
better and simpler way to achieve flashing. The 
Spectrum has a single command, FLASH, which 
produces the effect you want. 


How to turn flashing on and off 

FLASH can have one of two numerical values, 0 or 1. 
FLASH 1 makes a character flash, while FLASH 0 
stops it again. The next program will show you what 
effect adding FLASH has. First, type in the program 
without FLASH: 


PROGRAM WITHOUT FLASH 
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Line 10 sets up the screen with a blue BORDER and 
PAPER, and white INK. The range of x values in line 
20 (1 TO 704) is chosen because there are 704 character 











UES 2 


positions on the television screen (22 lines of 32 
characters). Now to make the display flash, add a new 
instruction to line 10 to make it read: 


10 FLASH 1:BORDER 1:PAPER 1:INK 7:CLS 


When you RUN the program this time, the INK- 
PAPER colours alternate, making the display flash. A 
screen full of flashing characters is rather difficult to 
look at, and, after a short time, you will probably want 
to stop it. If you type: 

FLASH 0 

however, nothing happens. ‘This is because the FLASH 
command only affects characters displayed after it. 
Instead, type CLS to remake the screen. The display 
should now stop flashing. 

FLASH can be incorporated in PRINT statements in 
the same way as OVER and BRIGHT. All these 
commands can be used in one of two ways. If you now 
remove FLASH 1 from line 10 and key in: 


30 PRINT FLASH 1;“#”; 


you will see the effect this has. Of course, you need not 
make the whole screen flash. In fact FLASH is a much 
more valuable command when used selectively. Try this 
display program: 


USING FLASH SELECTIVELY 
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“Transparent” colour and contrast 
Although the Spectrum has only eight screen colours, 
you may come across expressions using colour numbers 
8 or 9. Colour number 8 produces a "transparent" 
colour. If you use PAPER 8 in a PRINT line, the 
PAPER colour will be left as it was before. 

Colour number 9 does the exact opposite. If you've 
tried setting up your own colour screen, mixing the 




















available colours in different combinations, you will 
undoubtedly have discovered that some colours simply 
don’t mix well. In some combinations, text disappears 
into the background, making it totally unreadable. 
INK 9 is very useful for achieving perfectly readable 
text first time. It PRINTs characters in either black or 
white, whichever contrasts more with the background 
PAPER colour: 





INK 9 PROGRAM 
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Here a message is PRINTed against a background of 
each of the seven PAPER colours. The INK colour is 
chosen by the computer to contrast with the PAPER 
colour. White characters are PRINTed against black, 
blue, red and magenta backgrounds, but when the 
backgrounds change through green, cyan, yellow and 
white, the characters are PRINTed in black. 


Overprinting without erasing 

So far whenever you have PRINTed over text already 
on the screen, the original text has been blotted out by 
the new characters. However, this needn’t always 
happen. The Spectrum keyword OVER which you met 
on the previous two pages works with text characters as 
well as graphics. 

By using OVER, you can add characters together. 
For instance, lots of German words feature something 
called an umlaut — two dots above the letter a, o or u. 

The Spectrum can generate accents, umlauts and 
double symbols with programs that overprint text like 
the first example in the three screens that follow. The 
same principle can be used to underline words on the 
Screen, as you can see from the program in the centre 
screen in the next column. The underlining characters 
are PRIN Ted at exactly the same positions on the screen 
as one line of words. However, it doesn't, as you would 
normally expect, erase the words — it adds to them. You 
can see the result displayed on the bottom of the three 
screens. ‘Try taking out line 20 and see the difference 
that it makes: 



















10 PRINT ВТ 106,10;"Koln" 

20 PRINT OVER 1; ЯТ 10,11; 

зе PRINT AT 12,10; "Societe 

49 PRINT OVER 1;AT 12,14;" 

SO PRINT OVER 1; AT 12,16;"”" 
60 PRINT AT 14,10; "ОООООООО 

7Ө PRINT OVER 1; ЯТ 14,10;"---- 
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By using OVER, you can convert letters into graphics 
characters, create foreign alphabets or, in games and 
graphics programs, you can make a character appear on 
top of a background line. 




















SOUND, NOTES AND MUSIC 


A FOR... NEXT loop in lines 30 to 80 goes through all 
the possible p values from —60 to 69, sounding each 
note for a tenth of a second, and lines 10 and 20 PRINT 
a frame around the pitch number PRIN Ted by line 50. 


The Spectrum can produce a wide range of sounds, all 
under the control of a single command, BEEP. This is 
accompanied by two variables — d (the duration or 
length of the sound) and p (pitch). For instance: 


BEEP 1,0 


produces a beep one second long at a pitch of middle C. 
'The pitch of sounds is measured relative to middle C — 
above middle C, p is positive, below p it is negative. The 
Spectrum’s pitch values range from -60 to +69. 
Increasing the value of p by 1 increases the pitch of the 
sound by one semitone. A semitone is the change in 
pitch between, for example, C and C#. Although d 
represents the length of the sound in seconds, it is not 
restricted to a whole number; fractions of seconds are 
quite permissible. 

As you can see from the table of p values below, you 
can increase the pitch of a sound by an octave by adding 
12 to p. You can play the full range of Spectrum notes 
by RUNning the following program. It takes about 15 
seconds to complete the scale: 


PITCH SCALE PROGRAM 
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. Note I Pitch Value А 
G#,Ab | -16 4 8 20 32 M 
G 17 一 3 7 19 31 43 
F#,Gb -18 6 6 18 30 42 
E 19 -7 5 17 29 4 
Е -20 -8 4 16 28 | 40 
D#, Eb -21 -9 3 15 27 39 
р -22 -10 2 14 26 38 
C#,Db 23 =li 1 13 25 37 
C -24 =12 0 12 24 36 
В -25 13 =) и 23 35 
Аз, Bb -26 -14 -2 10 22 34 
А -27 15 =3 9 21 33 

















Measuring the Spectrum’s speed with sound 

The next program uses BEEP as a signal. If you want to 
find out how quickly your Spectrum works, you can 
write a program to make it carry out a long series of 
calculations, and then time how long it takes to 
complete the series. For an approximate timing, your 
watch will be accurate enough, and to get around the 
problem of having to look at your watch and the screen 
at the same time, you can use BEEP to mark the 
beginning and end of the program. Here is one way by 
which you can do it: 
SPEED TEST PROGRAM 
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After the program title has appeared, lingered a while 
(determined by PAUSE 100), the timing period begins. 
























A message on the screen and а BEEP lasting 1/10th of a 
second tell you when the calculation — adding together 
all the numbers from 1 to 1000 — has started. Some 
seconds later, there is a second BEEP, again lasting 
1/10th of a second but at a higher pitch, marking the 
end of the timing period. In that time, your Spectrum 
has not only performed 1000 calculations, but it has also 
PRINTed out 1000 results! Dividing the total time by 
1000 will tell you how long each calculation and 
PRINTing takes. 


Programming simple tunes 
With the BEEP command, it is quite easy to get the 
Spectrum to play a simple tune. Here to start with is a 
short sequence of notes. You just enter a BEEP 
command for each separate note: 

SIMPLE NOTE SEQUENCE 
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As all the BEEPs аге 0.5 seconds long, you could save a 
little typing time by using a variable, t, and setting it to 
0.5 at the beginning of the program. The BEEP 
statements would then look like this: 


— NOTE SEQUENCE - VARIABLE DURATION 
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the duration of a crotchet is set at a variable d, the b 
\ durations of other notes аге as below. 





The advantage of this is that you can then change the 
value of t at the beginning of the program, and all the 
timings will then alter in step. 






Music on the Spectrum 

If you want to write real music on the Spectrum, you 
will have to tackle the problem of timing. Musical notes 
can be of various lengths. If you call the duration of a 
crotchet d, then the durations of the other notes are 
related to it like this: 


























Semi-quaver (sixteenth note) ———— d/4 一 一 
J ---- Quaver (eighth note) d/2 
- T Crotchet (quarter note) d 
Minim (half note) -一 2xd 
-一 一 Semi-breve(wholenote) 4xd 

















You can then set about converting a piece of sheet music 
into a computer program. Here are a few bars of a tune 
which you will probably recognize when you get your 
Spectrum to play them. The musical score for the first 
few bars looks like this: 





Now it is just a matter of converting the notes. This 
listing sets d at 0.5; once you have entered the program 
you can vary the speed by altering this value. You will 
find that the pitch remains unaltered: 


TUNE PROGRAM 
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So far you have just used the BEEP command to 
produce musical notes. However, when you come to 
writing your own programs, you will often want some 
quite unmusical sound effects to give the screen display 
added realism. Menacing sounds add a whole new 
dimension to many programs. 


Writing sound loops 

The simplest sound effect you can produce uses two 
BEEPs, at different pitches, and then cycles between 
the two by using GOTO to make a loop. Here is a 
program that produces a siren effect: 


Е GOTO SOUND LOOP 





This simply plays a high note for a quarter of a second, 
followed by a lower note of the same length. You could 
write both BEEP statements on the same line so that the 
whole sound routine would take up only two lines: 


10 BEEP 0.25,9:BEEP 0.25,7 
20 GOTO 10 


Because this program is written as an endless loop, you 
will need to' press the CAPS SHIFT and BREAK keys 
to make it stop. However, by changing the loop to use 
FOR ... NEXT, you could incorporate it into a 
program as a sound effect that lasts for a set period of 
time, or that is repeated at intervals. 


Altering the duration of a sound loop 

The character of a sound can be changed dramatically if 
you shorten the playing time of the elements that make 
it up. By altering t in line 10 of either of the next two 
BEEP programs, you can hear the effect of shortening 
a sound sequence. These sorts of sound are often used 
in otherwise routine games to startle the player at a 
critical moment. The shorter the duration of the 
BEEPs, the more urgent the sound seems to become: 








чолеоюь» 
96565969 
omgogugor 





FOR nsi TO 15 


FOR Pzóo TO 
BEEP 0.005 .гр 
NEXT р 
NEXT n 














The sound programmed in the third screen illustrates 
what happens when the BEEP gets really short. The 
program uses just one BEEP statement, but it features 
a technique that you haven’t come across before — that 
of stepping backwards through a loop. The loop begins 
at p=60 and decreases p by 2 on each cycle until p=30. 
Each note sounds for only 0.005 (5 thousandths) of a 
second. If you make the note any shorter than this, it 
will sound like a click. You cannot produce a great 
variety of sounds with such simple sound commands. 
However, if you use sounds at the bottom end of the 
pitch scale, you can produce another type of effect. Try 
this program; it produces a chugging sound, rather like 
an engine: 





LOW PITCH LOOP 


Unpredictable sounds 

So far, you have had a good idea of what sound a 
program would have produced before you ran it. But 
now try this program. (You will find the keyword RND 
above the T key): 


RANDOM SOUND 
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Instead of giving the pitch a fixed value or a predictable 
range of values, this program lets the computer choose 
pitches at random. (The use of RND is covered fully on 
pages 48—49). 


Synchronized sound effects 

It's relatively easy to generate sounds in isolation, as 
you have been doing so far, but incorporating sound 
effects in a program successfully is more difficult. The 
trick is to get the sound at the right duration at the right 
part of the program. To illustrate how this is done, the 
next program makes a simple graphics character move 
from one side of the screen to the other, while 
generating a sound effect in step with the movement: 


~ SYNCHRONIZED SOUND AND ANIMATION 
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Instead of setting up user-defined graphics, the 
program uses the relatively coarse graphics available on 
the number keys. The character is composed of a total 
of eight separate symbols PRINTed over three lines. 
Normally, the character would be PRINTed and then, 
after a short time delay, erased before being PRIN Ted 
again one position further across the screen. 

'The delay makes sure that the character is on the 
screen longer than it is off, to minimize flickering. 
Here, though, the sound effect itself is used as a time 
delay. If one sound were made on each pass round the 
FOR ... NEXT loop (lines 20 to 130), it would be a 
rather disjointed, stuttering sound because of the 
relatively long silences. Splitting the sound effect into a 
number of different BEEP statements gets round that. 
It also makes more complicated sound effects possible 
than a single BEEP statement could produce. The 
lengths of the sounds are carefully chosen so that there 
is as little delay as possible between one character being 
erased and the next character being PRIN Ted. Since 
the BEEP command stops the program for as long as the 
sound is generated, it is necessary to display the 
character on the screen first and to generate the sound 
immediately afterwards. 








DECISION-POINT PROGRAMMING 





You have already looked at the concept of the loop in NEXT program. Line 80 is where the computer makes 
programs a number of times from page 26 onwards. If a decision as it examines n. The < symbol is 
you want to carry out a calculation or put something on mathematical shorthand for “less than”. So, if n is less 
the screen 10 times, you could write: than 10, the computer is told to go around the program 


FOR A=1 TO 10 again from line 40. The computer continually PRINTs 
NEXT A EF out A, А 1 2 and A | З until n is not less than 10 when, 
€ in this case, it stops: 

But there is another way of doing this, by using an IF ... — IF... THEN LOOP 

THEN statement. To take an example, let’s say you 
want to PRINT all the numbers from 1 to 10, together 
with their squares and cubes in a table. Here is how you 
would do it with FOR ... NEXT, and then with a TEES 
different program which uses IF ... THEN: ЗЕТА ТАСТАҒАН АТ 650; Lt" 


FOR...NEXT LOOP | 
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Why use the IF ... THEN loop? 
You might wonder what the point of this is, as the IF ... 
'THEN loop produces just the same results as the FOR 

. NEXT loop. The value of IF ... THEN is that the 
computer can respond to any information that you 
INPUT during the program's operation by making a 
decision about it. Here is an example which shows this, | 
by giving you a chance to test your skill at mental 
arithmetic (RND is explained on on pages 48-49): 
| MATHS TEST PROGRAM 
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In the IF ... THEN program which follows, line 10 sets 
up the colour screen, and line 30 PRINTS the table's 
heading as before. Line 40 is the first line of the loop - 
it increases n by 1 on every pass round the loop. Line 70 
is the same PRINT statement used in the FOR ... 























Each time the computer sets the problem and waits for 


action. If you type in a correct answer, the IF ... THEN 
statement at line 90 directs the computer to go, not to 
line 100, but to line 130 next - PRINTing a “correct” 
message and then setting another problem. If the 
answer is wrong, then the computer “falls through" the 
IF ... THEN statement to line 100 and goes into the 
"wrong" routine. 

It is important to remember that there must also be 
something in the program to stop the wrong answer 
routine carrying on into the correct answer routine. In 
this case, it is line 120, which makes the computer 
PRINT out the problem again: 

[ 


| MATHS TEST DISPLAY _ 


Creating graphics with IF ... THEN 
You can use IF... THEN in combination with graphics 
commands to turn your Spectrum into an electronic 
drawing system, All you have to do is program the 
computer to respond to an INPUT by DRAWing: 

_ IF... THEN GRAPHICS PROGRAM 
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In this simple program the IF ... THEN statements 
allow the computer to decide what action to take. This 
program uses the cursor keys to DRAW lines either 
horizontally or vertically from a point near the bottom 
left of the screen. 

The program simply PLOTS the point 25,25 and then 
DRAWs a small line every time you press one of the 
cursor keys. The four IF ... THEN lines make the 
computer examine your INPUT, and then decide in 
which direction the line should be DRAWn. Each time 
you use a key, remember to press ENTER so that the 
computer receives the instruction. 

The statement in line 30 tells the computer how long 
to make each line. Making x equal to 5 gives quite good 
results, but you might like to try altering its value to 
change the resolution of your pictures. In addition to 
this, of course, you can change colour simply by 
altering the numbers in line 10. This screen will give 
you an idea of what you can DRAW: 


IF ... THEN GRAPHICS DISPLAY 








Selecting the right condition 
Although you can extend this sort of program to use 
more keys, the Spectrum does have a better way of 
achieving the same effect, and having long rows of IF 
... THEN statements is not really good programming. 
But when you use IF ... THEN, remember that there is 
a great variety of “conditions” which can follow the IF 
part of the statement. The programs on these pages 
have used either < or =, but this is only part of the 
complete range of symbols that the Spectrum uses as 
you can see from the following table. Choosing the right 
condition is not always easy, especially when you are 
dealing with moving characters. 
IF...THEN CONDITIONS 


The symbols that follow the IF part of a line specify the kind of decision 








that the computer will make. 





= is equal to <> isnot equal to 


> is greater than < is less than 
> = is greater than or equal to < = is less than or equal to 

















Although computers generally work with precise 
information, doing exactly what you tell them to do, an 
element of chance is necessary in certain applications. 
For instance, most computer games are based to some 
extent on luck. If you want to make something happen 
at an unpredictable time, or if dice are to be thrown or 
coins tossed, you can’t tell the computer what result to 
produce every time or the element of chance would 
disappear. 

The way to build chance into a program is to use 
RND. You will already have come across this command 
— it was used to produce a series of random numbers for 
example in the maths test program on the previous two 
pages. RND, as you have probably guessed, stands for 
RaNDom and it allows you to generate random 
numbers up to a maximum that you can set. You can 
then use these numbers to produce unpredictable 
sequences. The command is used like this: 


10 A=RND 


This will make A a decimal number that is somewhere 
between 0 and 0.999999999, Try using RND in this 
program, which PRINTs numbers at random: 


RANDOM NUMBER GENERATOR 
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This uses RND in line 120 to generate random numbers 
between 0 and 0.999999999, while lines 30 to 100 set up 
a border of asterisks to frame the numbers. Very small 
numbers include the E symbol that you came across on 
page 17. Normally, as each new number is PRIN Ted, it 
automatically erases the last number ~ simply by 
PRINTing on top of it. However, when something like 
E-4 appears, it is not automatically erased, so the nine 
blank spaces in line 150 take care of that. 

The Spectrum can generate only the limited range of 
random numbers used in this program. To generate 
other random numbers, you have to manipulate RND. 
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Producing random whole numbers 
If you now replace line 120 with: 


120 PRINT АТ 10,14;INT (RND*10) 


and RUN the program again, you will notice an 
immediate change in the display. The numbers are no 
longer decimal fractions, in fact there's no decimal 
point at all. Instead, the program is generating whole 
numbers between 0 апа 9 inclusive - a much more 
useful result for programs. INT, which you came across 
on page 27, rounds the random number produced down 
to the nearest whole number, or integer. 

This way of using RND is very useful for 
programming games with chance built in. It is quite 
easy, for example, to get the Spectrum to simulate 
throwing dice or tossing coins: 


COIN TOSS PROGRAM 
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As a tossed coin can only have one of two values — heads 
or tails — line 20 produces a random number that is 
either 1 or 2. Tails are represented by 1 and heads by 2. 
Two IF ... THEN lines determine what is to be 
PRINTed, and then the program continues: 

COIN TOSS DISPLAY 
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Checking a random sequence 

It is possible to write a program that will show you just 
how random RND is. If you use RND to toss an 
electronic “coin” 100 times, you should get roughly 50 
heads and 50 tails each RUN. You can actually test to 
see if this is true. Key in this program: 
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When you RUN this, you will be able to see how close 
to 50:50 the heads and tails are each time the program is 
carried out. 


Using RND in graphics programs 

You can produce some interesting effects with RND by 
incorporating it in graphics programs, so that the 
computer is instructed to PRINT a character at a 

















random position on the screen. If you then make the 
computer repeat this a number of times by using 
FOR...NEXT you can build up a display which will be 
different every time the program is RUN. Here is a 
program which uses RND in this way: 

[ RANDOM GRAPHICS PROGRAM 
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Lines 10 to 80 define a character that is stored in the 
computer's memory and recalled by using the A key 
with the graphics cursor. Line 90 sets up a screen which 
is completely black - both BORDER and PAPER are 
set to 0. Lines 100 to 150 make up a FOR ... NEXT 
loop which selects a random position and a random 
INK colour, and which then PRINTS the character. 
PAUSE 0 (line 160) simply stops the program until any 
key is pressed, preventing the completion report from 
appearing: 

_ ВАМРОМ GRAPHICS DISPLAY 


You can also use the RND command in programs to 
make keyboard characters, or even random points, 
appear in random colours. To do this, use the command 
INK c(wherecisa random number between 1 and 7) in 
the same way as in line 140 of the program above. 





























COMPILING A DATA BANK 





The data necessary for a program can be collected while 
it is RUNning by using INPUT, or alternatively can be 
written into the program itself. The commands used to 
store data are quite straightforward. Data is held in 
DATA statements and read by READ statements. Here 
is a program which will show you the technique at 
work. Type in: 


CONSTELLATION PROGRAM Е 
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When you RUN this program you should see on your 
screen a computer-generated map of a group of stars, 
the constellation Ursa Major, also known as the Plough 
or Big Dipper: 

CONSTELLATION DISPLAY 





The information for the display i is carried in line 40 in 
the form of 14 co-ordinates. Line 70 tells the computer 
to READ the DATA in line 40, and to understand the 
DATA as pairs of figures which the program will refer to 
as x,y. Line 50 tells the computer that there will be 
seven of these pairs altogether. 








The computer first produces a short pulse of sound, and | of sound, and 

then PRINTs an asterisk AT each value of x,y, 
transforming the row of DATA into a map on the 
television screen. 

With a program like this it is easy to enter new DATA 
to get the computer to PRINT a new map. Here is a set 
of line changes and the map it produces: 

20 PRINT AT 0,11;“CASSIOPEIA” 
40 DATA 8,3,12,8,9,14,14,18,8,24 
50 LET n=5 








_ CONSTELLATION DISPLAY 





When you use DATA statements, it is important to tell 
the computer how much DATA there is to READ. Line 
50 in the constellations program shows you how to do 
this. It sets the limit for the number of pairs of co- 
ordinates that are to be READ, so when the computer 
has PRINTed the final star, it stops. If there was no 
FOR ... NEXT loop in the second half of the program, 
the computer would run out of DATA. If this happened 
the program would end with an error report. 


Storing numbers and strings together 

Strings, too, can be stored and READ using DATA 
lines, and you can also store a mixture of both numbers 
and strings — the names of friends and their phone 
numbers or birthdays, for example. This does present a 
problem though, because two different types of READ 
statement are used to read numbers and strings - 
READ a and READ a$, for instance. But if you make 
all the DATA, including the numbers, appear as 
strings, you can overcome this difficulty. 

The following program holds a personal telephone 
list. Names and telephone numbers are loaded by lines 
10 to 50. Lines 60 to 80 display the program title and 
then offer a choice of functions: 
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TELEPHONE LIST PROGRAM 
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To PRINT the whole telephone list, type: 
1 then ENTER 
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Alternatively, by typing in the following command: 
2 then ENTER 


you can find the number of just one name, after which 
the computer returns to the selection display: 





TELEPHONE LIST SELECTION DISPLAY 


PERSONAL TELEPHONE LIST 
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If you type in 2 at line 80, the program follows lines 160 
to 260. You are first asked to enter an initial and a name. 
Make sure that you PRINT in capitals and lower case as 
in the DATA lines, without spaces, or the computer will 
not recognize your entry. 

If the computer finds that the name (e$) that you 
typed in is the same as one of the names (n$) in the 
DATA statements, it will give a new string (r$) the value 
of n$ plus a line of dots and the telephone number. If it 
does not find e$, r$ is left unchanged at “Name not 
found” (set by line 180), and that is PRINTed out at the 
end of the program. 

Because you want to add the name, a line of dots and 
the telephone number together in line 220, the 
telephone number has to be treated as a string variable 
m$, instead of a numeric variable, m. If you used m the 
program would not work because string and numeric 
variables cannot be added together. 

Lines 190 and 260 use a new command, RESTORE. 
This tells the computer to go back to the beginning of 
the DATA statements when it carries out the next 
READ command. Without it, the program would only 
RUN correctly once. This would be because the 
computer would run out of DATA; it would try to 
continue searching the DATA after the final item, but 
the program tells it to READ all the available DATA on 
each RUN. RESTORE lets the computer start 
searching from the beginning of the DATA each time as 
if it was the first RUN. 

Once you know how to compile a DATA bank, you 
can use one to store your friends' birthdays, another to 
list bills and payments, or the details of your videotape 
or cassette library. 
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On pages 30-31 you saw how to program and store your 
own graphics characters using the commands POKE 
and USR. As you will have noticed, getting the 
computer to produce even one user-defined character is 
quite a lengthy business. Programming a single 
graphics key takes eight program lines, so if you want to 
produce a symbol made up from four separate 
characters, you would need 24 program lines. 
However, the graphics programs on pages 36-37 used a 
short-cut that can make producing your own characters 
much faster. 


Programming characters with READ ... DATA 
As you saw on page 30, to program a graphics character 
you need to enter the numeric value of each line in the 
character grid. Here are two programs which produce 
the same character. The first uses a separate program 
line to store each separate total from the character grid: 
SAVING LINES WITH FOR...NEXT ] 
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The second program instead stores the totals in a DATA 
line at the beginning of the program, and then converts 
them into the same character using a READ line. 

You can see from this that READ ... DATA cuts the 
number of lines needed from eight to five. But although 
this is a useful saving, the great advantage of the READ 

. DATA technique is that it actually saves you far 
more lines if you want to program a symbol that is made 
up from a number of characters, or if you want to use 
more than one symbol in a program. Then the savings 
become really worthwhile. 





Storing groups of characters 

Here is a program that reprograms four keys - a, b, c 
and d — to produce the symbols for four playing-card 
suits. Each of the symbols is produced by one loop. 
With a few extra lines you can create a display with the 
symbols: 








READ...DATA WITH 4 LOOPS 
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This way of producing the four symbols uses a total of 
16 lines. This is eight lines less than the simple but 
laborious method which uses eight POKE ... USR 
statements per character. However, you can save even 
more space by READing all the DATA in the program 
in one FOR ... NEXT loop. Here is what the program 
would look like: 


READ...DATA WITH 1 LOOP 
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At first sight, all the DATA seem to have changed. 
However, all that has really happened is that the DATA 
numbers have been keyed in a different order. The 
DATA is still held in the first four lines — 10 to 40. Line 
60 tells the computer to READ this DATA in groups of 
four numbers, w,x,y,z, and each of these numbers 
reprograms a separate key. So the numbers that 
reprogram the A key are first, fifth, ninth, thirteenth, 
and so on. The key DATA are arranged like this: 


DATA a,b,c,d,a,b,c,d,a,b,c,d ... 


All you have to do to use this with your own symbols is 
to add up your grid totals, as in the diagram on page 30, 
and then make them into DATA dines by putting them 
together in the correct order. Now instead of saving 
eight lines of program, you will have saved thirteen. 


How to use binary numbers with graphics 
Unless you use a calculator, programming graphics 
characters can be quite a test of your ability at adding 
up. The code numbers for each column of squares in the 
character grid are not the most convenient numbers to 
deal with, and it is quite easy to make mistakes. But the 
Spectrum does let you key them in in another way, 
using the command BIN, which stands for BINary. 
All computers use a binary system of electronic 
pulses to carry information. The word binary means 
that there are only two types of pulse — “оп” or 1, and 
"off" or 0. All your programs are simply a stream of 
these electronic pulses. Every number that you type 
into the Spectrum is converted into a series of these 











“оп” or “off” pulses, but because humans are not very 
familiar with the binary system, the computer is 
designed to accept "ordinary" numbers. 

The command BIN by-passes this process and lets 
you enter binary numbers directly. BIN precedes a 
number that is written in multiples of two, instead of 
multiples of ten. Reset the computer and see what 
happens when you key in the following: 


PRINT BIN 10 
PRINT BIN 100 
PRINT BIN 1011 


Instead of seeing 10, 100 and 1011 on the screen, you 
should see 2, 4 and 11. The computer has converted the 
binary numbers back into “ordinary” numbers. The 
computer's ability to accept binary numbers is not of 
great value in simple programming. However, you can 
use the BIN command to save yourself having to do 
calculations when reprogramming keys. 

You will remember that when you use a character 
grid, the numbers across the top of the grid go up in 
jumps. Each number is twice the one to its right. The 
computer actually gives each column a binary code, 0, 
10, 100, 1000 and so on, so you can use binary numbers 
to enter the way a character is to be made up. Here is a 
grid numbered in this way: 





If you imagine that each filled-in square has a value of 1, 
and each empty square has a value of 0, you can enter 
the screen totals as sequences of ones and zeros using 
the BIN keyword or simply use BIN in a series of direct 
commands to PRINT each total in decimal. The great 
advantage of using BIN is that although the binary 
numbers look long, there is no adding up to be done. 
You simply key in what you see, counting black as 1, 
and white as 0. 








ADVANCED COLOUR GRAPHICS 


Having tried some simple colour graphics on pages 36— 
37, you can now move on to putting all the graphics, 
colour and animation commands together in one 
program to experiment with the ways they interact with 
one another. 'The program on these two pages produces 
a complex picture; if you work through this listing, you 
should be able to write a similar program yourself. 


Creating a landscape 

The first step in producing a display is to program it in 
black and white. Here is a listing that does that, using 
the *scrambled" DATA system that is dealt with on the 
previous two pages, and also using PLOT and DRAW 
to fill in two “pyramids”: 
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The DATA lines (10-40) define four characters that are 
PRINTed together by lines 240 and 250 to produce the 
Sun. Lines 50 to 110 transform the information in the 
DATA lines into user-defined characters that are 














controlled by keys a, b, c and d. Lines 120 to 150 
PRINT seven lines of the graphics character on the 8 
key to form the foreground. Lines 160 to 230 then 
DRAW the two pyramids as simple triangles. 

Once you have keyed in all the program, RUN it to 
make sure that you have typed it correctly. If the 
following display appears, you are ready to move on to 
the next stage: 

— DISPLAY BEFORE COLOURING 





Programming colour and perspective 
Now it is a simple matter to add the colour: 


5 BORDER 0:PAPER 1:CLS 
140 PRINT INK 2;AT г,с, IM" 
235 INK 6 


When you RUN the program, the changes should result 
in the BORDER turning black and the PAPER blue, 
followed by a red foreground and yellow Sun. 

You can now add the perspective lines, to give the 
display a feeling of depth". The lines should produce 
the same effect as parallel paths disappearing into the 
distance. You need to DRAW lines between two 
horizontal rows of co-ordinates, with the top points 
being closer together than the bottom ones. Try keying 
in these lines: 


260 LET w=8: INK 7 

270 FOR x- 72 TO 184 STEP 16 
280 PLOT x,38 

290 DRAW w—x,—38 

300 LET w=w+34 

310 NEXT x 


The x co-ordinate of the top (most distant) end of each 
line is given by line 270. STEP 16 makes x increase by 
16 each time instead of 1. The graphics cursor is then 

















moved to the top of the line by PLOT x,38. Each line is 
DRAWn from that point to the bottom of the screen by 
line 290. Then, to make the x co-ordinate of the bottom 
of the line (м/-х) step across the screen in bigger steps 
than the top, line 300 increases w by 34. Once you have 
done this, RUN the program again: 

“CHUNKY” GRAPHICS DISPLAY 





As you will see, it produces odd results. The lines are 
DRAWn as large squares. What has gone wrong? 


DRAWing lines on colour 
The answer is that although the Spectrum’s graphics 
use 256х176 pixels, INK colour resolution is only 
32x22, the same as the text resolution. These large 
squares are known as “chunky graphics". As the lines 
are DRAWn, they automatically change the colour of 
every square they pass through. However, if you watch 
the top half of the screen as the picture forms, you will 
see that the lines used to DRAW the pyramids do not 
produce these chunky graphics. One further change is 
needed to create this complete non-chunky display: 
CORRECTED DISPLAY 








o OK, 














The problem is that lines can be DRAWn successfully S 
on background PAPER colour but not on INK. 

You must therefore rewrite the program so that the 
red ground is DRAWn as a background PAPER colour 
- not as INK. You can do this simply by changing line 
140 to PRINT with red PAPER: 


140 PRINT PAPER 2;АТ г,с;“ " 


Now the perspective lines will appear successfully. 


Adding a moving character 
For the final touch, you could add a bird flying across 
the screen. You can produce this by using two user- 
defined characters, and alternating them to simulate the 
bird's flapping wings: 

DATA AND ANIMATION LINES 





DATA 0,16, 
DATA 252,2 


FOR n=e то 
READ t,v 
POKE - 
POKE 

NEXT 
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*,C; 
BEEP 0.02,45 


Lines 410 and 420 use IF and THEN to make the 
computer check whether c, the bird’s column position, 
is even or odd. If it is even, the bird’s body alone is 
PRINTed, if it is odd, then a flapping wing is added. 
The display is now complete: 

FINAL DISPLAY 




















You will often want to use the same few lines of a 
program again and again to carry out the same 
calculation or to display the same group of characters on 
the screen. To avoid writing out the same lines time 
after time (and using up too much of the computer’s 
memory) you could branch off to frequently-used 
sections of the program with GOTO. However, relying 
on GOTO is frowned on by many programmers. Using 
it carelessly can turn your programs into untidy mazes 
that are impossible to understand or debug. 

The easiest program to analyze and debug is one that 
is written methodically in blocks or modules, each of 
which you can test independently of the others, if 
problems arise. If you look up the listing of a good 
games program in a magazine, for example, you will 
find that it works something like this: 
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How to use a subroutine 
Frequently-used blocks of programs, or subroutines, 
are written using the command GOSUB. This allows 
you to branch off from the main program to the 
subroutine and then return to the main program again. 
The command looks like this: 


50 GOSUB 500 


Here the main program RUNS normally until it reaches 
line 50, which makes the computer jump to a 
subroutine at line 500. After it has been through the 
subroutine, it returns to the main program at line 60 — 
the one after the line where it left. The subroutine must 
be ended by the word RETURN. Without it, the 
computer will not go back to the correct point in the 
main program. 

You can use GOSUB in almost any program where 
the computer has to repeat an operation. The next 
program produces a temperature conversion chart, 
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using three types of measurement, Centigrade, 
Fahrenheit and Kelvin. The subroutine at line 80 
makes the computer PRINT out a line on the table, 
produce a short BEEP, and then return to line 60. The 
command STOP at line 70 stops the program carrying 
on into the subroutine. If you miss out STOP, the 
computer will reach the RETURN command at line 
110. It would then produce an error report because it 
had encountered a RETURN without its own GOSUB. 
You will notice that the subroutine in the listing below 
is inside a FOR ... NEXT loop, so it is “called” a 
number of times. The display produced when you 
RUN this program is shown on the bottom screen: 


TEMPERATURE CONVERSION PROGRAM 
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In this program, the subroutine is not actually saving 
any space. However, if you extended the program to 
carry out other functions, the subroutine could be 
“called” again as often as you wanted — saving both 
space and memory. 























Setting up displays with GOSUB subroutine at line 270. The subroutine produces a 
In many programs, you are initially given a “menu” or sequence of changing BORDER colours while 
choice of options to select. This choice is often BEEPing, and then replaces the target, restarting the 
programmed by using GOSUB. When you enter your progran The bottom screen shows the display: 
selection, the program goes to the appropriate GOSUB ANIMATION PROGRAM 


subroutine and sets up the display you have picked. 

Here is a simple listing that shows how you can do 
this. The program can set up either of two basic 
displays. One is illustrated on the bottom screen. The 
colours in each display are produced by a subroutine — 
which subroutine is used depends on your INPUT 
following line 20. If you were using this subroutine in a 
real games program, you could use these colour settings 
often by putting in a GOSUB: 


or 
* 0 
POR 
559 
999 
1*00moOOPD 227 
XXDX220-4 444 


21277-09 


MENU PROGRAM 





^ бофчолвопебоочелвна 
o 96996959565995595655909 


^ Пеевверевев 


22 

co 

4m 
" 


NOTE NE 
550205552022050,2% 
злятонн но 
12002011 ZO 

пова 

407DMe и 


ххн2272 


DRAW 
NEXT 


ююоюю 
OANFONE 





осооспюоюню 
опебооч 
659655059969956 





Using GOSUB with animation 

Here is a program which PRINTS a target — two 
graphics symbols on the ground — and which then 
PRINTS a succession of aliens falling from random 
points at the top of the screen. If one of the aliens then 
hits the target, line 240 directs the computer to go to the 
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When you are learning to program your Spectrum, you 
will have come across a number of ways of improving 
your technique by trial and error. However, there are 
some ways of saving time or sorting out problems 
which, although simple and effective, are not 
necessarily obvious. On these two pages you will find 
some "tricks" which will help you to produce programs 
that are well organized and bug-free. 


Using REM as a marker or mask 

Because the REM command makes the computer 
ignore anything that follows it in a line, it can be used in 
labelling and testing parts of a program. On page 18 you 
saw how REM can be used in the first line of a program 
to show you what a program does, and the longer a 
program is, the more useful this becomes. 

However, when a program gets really long, it is 
sometimes difficult to pick out the REM lines among all 
the others. One way you can draw attention to them is 
by following REM with some symbols which clearly 
stand out from the rest of the program. Here is one way 
of doing this: 
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When you read through this program, the REM lines 
are visible at a glance. 

REM also has a use in program development. You 
will often want to test a program to see what happens if 
certain lines are left out. This. may be because part of a 
program takes a long time to RUN, or produces a BEEP 
that you don’t want to hear time and time again. 

You can skip part of a program by using GOTO or 
RUN followed by a line number, but this won’t help if 
you just want to miss out a few lines in the middle. The 
way to deal with this problem without deleting the lines 
is to insert a REM command at the beginning of each 
line you want to skip. This will mask or “disable” the 








lines, as the computer will ignore all the commands 
following each REM. Here is a program in which this 
has been done: 

LINE DISABLED WITH REM 
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How to check nested loops 
When you use a number of loops in a program, it is easy 
to get the loops tangled so that the program does not 
produce the results you want. There is an easy way to 
check whether the loops are correctly “nested” — or that 
they fit inside each other without overlapping. 

If you note the program down (or better still, if you 
can print it on a printer) you can connect the start of 
every loop up with its end: 


LINKING LOOPS 





Alternatively you can jot down every FOR and NEXT 
in a program on а piece of paper in the order in which 
they appear, missing out the intervening lines. It's then 
an easy process to link the loops up. 














If all the loops are correctly nested, none of these lines 
should overlap. If they do, you have wrongly nested 
loops, and the chances are that the program will not 
work correctly. 


Improving keyboard feedback 

Every time you press a key on the Spectrum, the 
computer makes a click. It's very useful. Without it, 
you have to keep looking at the screen to make sure that 
every key press has been registered by the computer. 
However, although it is loud enough for work in quiet 
surroundings, it can be drowned by noise from any 
other source, making programming more difficult. If 
the keyboard click isn't loud enough, you can increase 
it from a click to a more distinct BEEP by typing: 


POKE 23609,n 


where n is a whole number from 0 to 255. Zero produces 
a click, 255 a long, high-pitched note. 


How to speed up editing 

If you want to edit a line in the middle of a long 
program, you can simply type ina LIST instruction like 
this: 

LIST 250 


This will bring the line indicator down to the line to be 
edited. However, if the LISTing continues onto a 
further frame, the “scroll?” prompt appears at the 
bottom of the screen. If you press CAPS SHIFT and 
EDIT, the program will just scroll onwards to the next 
“раве”. You can press М to stop the listing scrolling and 
then carry on with editing, but there is an alternative 
that eliminates "scroll?" altogether. 
If you want to edit line 250 in a long program, type: 


249 


followed by ENTER. Nothing much seems to happen. 
'The line marker doesn't move. But more importantly, 
"scroll?" doesn't appear either. If you now press CAPS 
SHIFT and EDIT, line 250 then appears at the foot of 
the screen ready to be edited. The 249 — or whichever 
number you choose - should be a number which 
immediately precedes the number of the line that you 
want to edit. Make sure though that the number you use 
is not a line number already in the program. If itis, then 
typing the number followed by ENTER will erase the 
program line from the computer's memory. 


Useful debugging techniques 

Although the Spectrum has a large repertoire of error 
reports which will alert you to any incorrect lines in a 
program, often a program will RUN without any 
hitches, only to produce a result entirely different to the 
one you had in mind. How then do you go about finding 
the source of the problem? 





%, 


As you have just seen, you can use REMs to mask parts 
of a program, or you can link loops to check that they 
are nested properly. But if that doesn’t help, you can 
often track down the problem by giving each variable in 
a program one set value, instead of allowing it to go 
through many. 

Imagine that you have a graphics program which uses 
the command RND to produce a display which is built 
up by looping. If it does not work in the way you expect, 
you can take out the RND, and instead use a number. 
You can then work out what effect this number should 
have when the program is RUN. Now take out the lines 
that start and terminate the loop (you can use REM for 
this). If the result of a single RUN through is not what 
you predicted, the display should give you some idea of 
where your program is going “wrong”: 


PROGRAM EDITED FOR TESTING 
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Above is the random graphics program from page 49, 
edited so that the random variables in lines 110 and 120 
are fixed. The original lines are still kept in, but are 
disabled by REMs. The loop between lines 100 and 150 * 
is also disabled by a pair of REMs so the program only 
PRINTS once. 

If the program is RUN, you can check whether or 
not the program has done what was expected, and if 
not, it is now much easier to work backwards to the 
source of the problem. You can use this technique in 
any program which uses variables. By substituting a 
single value for each variable, you can check your 
expected result with the result when the program is 
RUN. 

Finally, don't forget that the BREAK key can be very 
helpful in telling you how far the computer has got 
through a program. If you RUN a program which either 
seems to do nothing, or gets stuck at a certain point, the 
BREAK key will tell you where the hold-up lies. If you 
then LIST the program, you will often be able to 
identify the problem with the line identified by BREAK 
and correct it. 

















Whatever you type into your Spectrum is only stored in 
the computer’s memory as long as it is supplied with 
power. When you switch the computer off, your 
program disappears. Obviously, you can’t type in every 
program you want to use afresh each time you switch on 
the computer. Fortunately, you probably already have 
a means of storing programs cheaply and easily — an 
ordinary tape cassette recorder. The Spectrum has two 
sockets on its rear panel, labelled EAR and MIC, and 
these should be connected to the corresponding 
recorder sockets. 


Setting the cassette controls 

Having connected a recorder to the computer, the next 
job is to set the volume and tone controls properly. If 
there is a tone control, set it to maximum treble. The 
volume control may need a little more experimentation. 
Set the volume control midway between minimum and 
maximum. 

Programs are recorded on tape and loaded back into 
the computer using two commands ~ SAVE and 
LOAD. You can test these commands by trying to 
SAVE any program from this book. Type the program 
into the computer again. RUN it to make sure that there 
are no typing errors and then unplug the EAR 
connection. Now give it any filename you like and ask 
the computer to SAVE it: 


SAVE “FOR...NEXT” 
The computer will reply with: 
Start tape then press any key 


Press RECORD and PLAY on the tape recorder and 
then press one of the computer keys. Two types of 
screen pattern will appear: 

ae CASSETTE SCREEN DISPLAY 




















CASSETTE SCREEN DISPLAY 









Program. ҒОР...МЕХТ 








When the program has been SAVEd, the pattern of 
lines disappears and the OK prompt reappears at the 
bottom of the screen. Stop the tape. 


Checking a recording 
То check that the program has been recorded properly, 
reconnect the EAR lead and type: 


VERIFY “FOR.. -NEXT” 


Start the tape playing again. As each program recorded 
on the tape is played back into the computer, the 
pattern of red and blue stripes should reappear on the 
screen, followed by the program’s name. If not, then 
the program has not been SAVEd properly. Rewind the 
tape, turn up the volume and press PLAY. If you still 
cannot VERIFY the program, interrupt VERIFY by 
pressing CAPS SHIFT plus BREAK. Try recording 
the program again at a higher volume setting (don’t 
forget to remove the EAR plug). 

You can use VERIFY to catalogue all the programs 
on a tape. Type VERIFY "cats" (ог any other filename 
that you know you have not used). As each program on 
the tape is read by the computer, its filename will 
appear on the screen. 





Playing back a program 
Now try LOADing the program back into memory. 
Type in the filename like this: 


LOAD “FOR...NEXT” 


Make sure the tape is rewound. Start it playing. When 
the computer finds the program, “program:” followed 
by the filename will appear on the screen. When the 
program is fully LOADed, the OK screen prompt 
reappears. Now you can RUN the program. 
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Тһе grid below shows the co-ordinates of the screen The second co-ordinate sets the vertical position 
display when graphics commands are used. A point on measured from the bottom of the screen. A character 
the screen is identified by two co-ordinates x,y. The PRINTed on the screen occupies an area that is 8 
first co-ordinate sets the horizontal position which is graphics units wide and 8 graphic units high. You 
measured along from the left-hand side of the screen. cannot PRINT on the bottom two lines of the screen. 
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Character grids These grids can be used 
to design cither a single character (above) 
or a symbol made from up to four 
characters (right). You can pencil in your 
design on the grids and then use the blue 
columns to list the row totals. These are 
used in a program with the commands 
POKE USR. Keys A to U are free for 











programming user-defined characters. 
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— Entries in bold type are BASIC keywords. 





AT 
Used with PRINT to place characters on the screen. 
































BASIC 
Beginners’ All-purpose Symbolic Instruction Code; 
the most commonly used high-level programming 
language. 





BEEP 

Makes the computer sound a short note or beep, whose 
duration and pitch are determined by the numbers 
following the command. 





BIN 
Converts a number written in binary into the equivalent 
number written in decimal. 


Bit 
A binary digit — either 0 or 1. 


BORDER 
Changes the colour of the screen's border area. 


BRIGHT 
Turns specified characters to a brighter shade of 
their INK colour. 


Byte 
A group of eight bits. 


Chip 
A single package containing a complete electronic 
circuit. Also called an integrated circuit (IC). 


CLS 
Clears the text area of the screen. 


CPU 

Central Processing Unit. Normally contained in a 
single chip called a microprocessor, this carries out the 
computer's arithmetic and controls operations in the 
rest of the computer. 





Cursor 
A flashing symbol on the screen, showing where the 
next character will appear. 


DATA 
Stores a line of data. The computer treats whatever 
follows DATA as information that may be needed later 
in the program. Used in conjunction with READ. 
















Draws a line in the current INK colour from the 
graphics origin at 0,0 or the last point visited to a point 
specified. 


FLASH : 
Makes characters flash on the screen. 


Flowchart 
A diagrammatic representation of the steps necessary 
to solve a problem. 


FOR...NEXT 
A loop which repeats a sequence of program statements 
a specified number of times. 


GOSUB 

Makes the program jump to a subroutine beginning at 
the line number following the command. The 
subroutine must always be terminated by RETURN. 


GOTO 
Makes a program jump to the line number following 
the command. 


Hardware 
The physical machinery of a computer system, as 
distinct from the programs (software). 


IF... THEN 
Prompts the computer to take a particular course of 
action only if the condition specified is detected. 


INK 

Changes the colour of text and graphics that appear on 
the screen. 
INPUT = 
Instructs the computer to wait for some data from the 
keyboard which is then used in a program, 


INT 
Converts a number with a decimal fraction into a whole 
number. 


Interface 
'The hardware and software connection between a 
computer and another piece of equipment. 


INVERSE 
Switches the PAPER colour for the INK colour and 
vice versa. 


K 
Abbreviation of kilobyte (1024 bytes). 


LET 


Assigns a value to a variable. 


Makes the computer display the program currently in 
its memory. 


LOAD 
Transfers a program from a cassette tape into the 
computer’s memory. 


Loop 
A sequence of program statements which is executed 
repeatedly or until a specified condition is met. 


NEW 
Removes a program from the computer’s memory so 
that a new program can be keyed in. 


OVER 

Allows new characters to be PRINTed on top of 
existing characters without erasing the existing 
characters. 


PAPER 
Changes the screen’s background colour. 


PAUSE 
Halts a program for a period set by a number measured 
in fiftieths of a second. 


PLOT 
Makes a single dot appear on the screen at the point 
specified by the co-ordinates that follow it. 


POKE USR 
Stores a number that reprograms a key to produce a 
user-defined character. 


PRINT 
Makes whatever follows appear on the screen. 





RAM . 

Random Access Memory (volatile memory). A memory 
whose contents are erased when the power is switched 
off. See also ROM. 


READ 

Instructs the computer to take a specific number of 
items from a DATA statement so that they can be used 
in a program. 


REM 

Enables the programmer to add remarks to a program. 
The computer ignores whatever follows REM in a 
program statement. 


RESTORE 
Resets the point from which DATA items are READ, 
so that items can be used more than once in a program. 


RETURN 
Terminates a subroutine. (See also GOSUB). 


RND 
Produces numbers between 0 and 1 at random which 
can be used to produce unpredictable sequences. 


ROM 

Read Only Memory (non-volatile memory). A memory 
which is programmed permanently by the 
manufacturer and whose contents can only be read by 
the user's computer. 


SAVE 

Records a program currently in the computer's memory 
onto a tape cassette. The program is identified by a 
filename. 


Software 
Computer programs. 


SQR 
Produces the square root of the number that follows it. 


STEP 
Sets the step size in a FOR... NEXT loop. 


STOP 
Halts a program and PRINTS out the line number in 
which it appears. 


String 
A sequence of characters treated as a single item — 
someone’s name, for instance. 


Subroutine 

A part of a program that can be called when necessary, 
to produce a particular display or carry out a number of 
calculations repeatedly for example. 


TAB 
Used with PRINT to specify how far along a line 
characters are to appear. 


Variable 

A labelled slot in the computer's memory in which 
information can be stored and retrieved later in a 
program. 


VERIFY 
Checks that a program that is currently in memory has 
been recorded correctly on a tape cassette using SAVE. 





Main entries are in 
bold type 


Animation 32-3, 36-9, 
54-5, 57 

Arrow keys 16-7, 22 

AT 15, 25, 62 


BASIC 6, 18, 22, 28, 62 

BEEP 10, 42-5, 62 

Binary code/BIN 8, 53, 
62 


Bit 8, 62 

BORDER 10, 34-7, 62 

BREAK 11,23, 26, 59, 
60 

BRIGHT 339, 62 

Bug see Debugging 

Byte 8, 62 


Cable 12, 13 
CAPS SHIFT key 10- 
11, 29, 59, 60 
Cassette tape recorder 6, 
7,9, 13, 60, 63 
Character 6, 10-11, 15, 
40-1, 62, 63 
— graphics 52-3 
— grids 30-1, 52-3, 61 
— user-defined 31-3, 
35:37, 952, 54, 61 
Chip 8-9, 62 
Circuit board 6, 8-9 
Clock, internal 8 
CLS 14, 34, 62 
Colour 6, 12-3, 34-9, 
54-5, 62 
— keys 10-11 
Connecting up 6-7, 
12-13, 60 
Connectors 6—7, 8, 13 
CPU (Central Processing 
Unit) 8-9, 62 
Cursor 11, 22, 29, 37, 
38, 62 


DATA 50-1, 52-3, 54, 
62, 63 

Debugging 18, 22-3, 
56, 58-9 

DELETE 11, 22 

DRAW 28-9, 38-9, 47, 
545, 62 








E (Exponent) 16-17, 48 

EDIT 10, 22, 59 

ENTER 10, 11, 12, 14, 
18, 22-3 

Error message 17, 23, 

59 


Fields 15 

Filename 60, 63 

FLASH 40-1, 63 

Flowchart 19, 62 

FOR ... NEXT 26-7, 
33, 44, 46, 52-3, 58, 
62, 63 


GOSUB 56-7, 62 

GOTO 21, 26, 44, 56, 
58, 62 

Graphics 10, 23, 28-33, 
36-9, 47, 49, 54-5, 61, 
62 


— characters 29, 30-31, 
41, 54, 61 

- grid 28, 30-1, 38-9, 
52-3, 61 

— key 10-11 


Hardware 6-13, 60, 62 


IF ... THEN 46-7, 62 

INK 10, 34-5, 38, 40- 
1, 49, 54-5, 62 

INPUT 23, 24-5, 27, 62 

INT 27, 48, 62 

Interfacing 6-7, 13, 60, 
62 


INVERSE 38-9, 62 
Joystick 6, 7 


K (Kilobytes) 6, 8, 62 
Keyboard 6-7, 8, 10—11, 
23,59 


LET 15, 63 

Line-numbering 18-19, 
22 

LIST 20, 59, 63 

LOAD 23, 60, 63 

Loops 19, 26-7, 44—5, 


.. 46, 52-3, 56-7, 58-9, 


62,63 
Loudspeaker 6, 9, 12 





Machine code 8 

Mathematical symbols 
15, 16, 46-7 

Memory 6, 8-9, 18, 20, 
23, 56, 60, 63 

Menu 57 

Microdrives 6, 7, 13 

Modes 10, 11 

Modules 36, 56 


NEW 8, 21, 63 
Number keys 10-11, 45 
Numbers see Variable 


OVER 38-9, 63 


PAL encoder 8 

PAPER 10-11, 34-5, 
36-41, 55, 62, 63 

PAUSE 27, 33, 63 

Peripherals 6—7, 13 

Perspective 54 

Pixels 28 

PLAY 60 

PLOT 28-9, 38-9, 54, 
63 

POKE 59 

POKE USR 30-1, 37, 
61, 63 

Power supply 6, 8,9, 12, 
13, 18 

PRINT 10, 14, 16, 18- 
19, 23, 31, 34, 38, 40, 
62, 63 

Printer 6, 7, 13, 58 

Punctutation 15, 17, 19, 
22, 23 


READ 37, 50-1, 52, 62, 
63 

RECORD 60 

REM 18, 58, 59, 63 

RESTORE 51, 63 

RETURN 56-7, 62, 63 

RND 45, 46, 48-9, 59, 
63 

RUN 18-19, 21, 23, 58, 
59, 63 


SAVE 60, 63 

Scroll 21, 23, 36, 59 

Setting-up 12-13, 60 

Socket 6, 7, 9, 60 

Software 63 

Sound 6, 8, 10, 12, 42-5, 
59, 62 





SPACE 11, 23 

Speed 27, 33, 42-3, 56 

SQR (Square root) 16- 
17, 23, 63 

STEP 63 

STOP 23, 63 

String see Variable 

Subroutine 56—7, 62, 63 

SYMBOL SHIFT key 
10-11 


'TAB 15, 63 

Time delay 33, 45 

Tuning-in 12, 35, 60 

TV receiver 6-7, 12, 13, 
35 


Variable 14-15, 19, 23, 
24—5, 50-51, 59, 63 

VERIFY 60, 63 

Video monitor 12-13 





The original and exciting new teach-yourself programming 
course for ZX Spectrum owners. 


Over 150 unique screen-shot photographs of program 
listings and programs in action—showing on the page exactly 
what appears on the screen. 


Packed full of programming tips and techniques, reference 
charts and tables, and advice on how to get the most out of 
TT your ZX Spectrum. 
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THE DK SCREEN-SHOT PROGRAMMING SERIES 
Never has there been a more urgent need for a series of well-produced, 
straightforward, practical guides to learning to use a computer. It is in 
response to this demand that The DK Screen-Shot Programming Series 
has been created. It is a completely new concept in the field of 
teach-yourself computing. And it is the first comprehensive library of 
highly illustrated, machine-specific, step-by-step programming manuals. 


BOOKS ABOUT THE ZX SPECTRUM 
This is Book Two in a series of unique step-by-step guides to 
programming the ZX Spectrum. Together with its companion volumes, it 
will build up into a self-contained teaching course that begins with the 
basic principles of programming, and progresses — via more 
sophisticated techniques and routines — to an advanced level. 


BOOKS ABOUT OTHER COMPUTERS 
Additional titles in the series will cover each of the world’s most popular 
computers, These will include: 
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After taking a B.Sc, in Applied Physics and a postgraduate diploma in 
Journalism at The City University, London, lan Graham worked as 
assistant editor of Electronics Today International and deputy editor of 
Which Video? Since becoming a full-time freelance writer in 1982, he has 
contributed to a wide range of technical magazines (including Computing 
Today, Video Today, Video Search, Hobby Electronics, Electronic Insight, 
Popular Hi-Fi, Science Now, and Next...) and has also written a number of 
popular books on computers and computing. These include Computer & 
Video Games, Information Technology, The Inside Story — Computers, 
and The Personal Computer Handbook (co-written with Helen Varley), 
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All computers feature a range of built-in functions, 
commands which can be used to transform one number 
into another in a specific way. Functions produce a 
result that can be used later in a program. SQR (SQuare 
Root) or INT (INTeger) are two examples of functions 
that are pre-programmed on the Spectrum. When you 
use these commands, they take a number and operate 
on it to produce another number. 

The range of keyboard functions on the Spectrum is 
quite wide. But if you want to use a function that does 
not appear on a key, you don’t have to type out a chain 
of instructions every time. The Spectrum allows you to 
program it to carry out specific sequences of 
calculations. These functions are “called” by the 
command FN (FunctioN) and defined by the command 
DEF FN (DEFine FunctioN). 


How to write a function 

In order to use a function, you must first define what it 
is going to do. That is done with a defining statement. 
For instance: 


120 DEF FN a(x)—4*x- 36 


*a » 


defines a function called . The number that a 
function operates on is Eason as its argument. In this 
case the argument of the function is x. The function 
takes whatever value of x it is given, multiplies it by 4, 
and then adds 36. If in a program you want to put the 
number 10 into the function, you would do so by using 
the keyword FN like this: 


200 PRINT FN a(10) 


This would PRINT the value of the function when 10 is 
substituted for x — which is 4*10+ 36, or 76. 

DEF FN is obtained by pressing CAPS SHIFT 
together with SYMBOL SHIFT, followed by SYMBOL 
SHIFT again to get the extended mode cursor, together 
with key 1. The same procedure, but using key 2 instead 
of key 1, produces FN. 

Once a function has been defined in a program, you can 
use it and its argument just like any other number or 
numeric variable. For example, you can add, subtract, 
divide and multiply functions and their arguments 
together, and even make functions work on numbers that 
are themselves produced by functions. Unless you are 
doing mathematical research you are unlikely to get this 
far, but for more straightforward tasks functions are easy 
to use and helpful in making programs simpler. 


Why use a function? 

The following program shows a simple way in which 
you can put functions to work in a program to produce 
a numerical result which is then PRIN Ted: 
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The program carries out a conversion. The function that 
actually does the converting is defined in line 30. Line 40 
waits for you to type in a number of gallons, which is then 
converted into the equivalent number of litres by FN c(1) 
in line 60. Multiplying and dividing by 100 may look odd, 
but it’s just a way of producing an answer to two places of 
decimals with INT. Using INT on its own removes all 
decimals, and so reduces accuracy. 

Going to the trouble of using a function here might 
seem a bit unnecessary, and in fact it’s unlikely that you 
would use FN in such a simple program. But imagine 
what would happen if you wanted to do the calculation 
a number of times at different places in the same 
program, and with different numbers. It is then that the 
user-defined function really comes into its own. When 
the function is long and complicated, defining it just 
once enables you make calculation lines much simpler 
to write and check. FN is very much like a one- 











command subroutine that deals only with numbers. 

Because an expression containing FN actually 
represents a number, you can use it to replace any kind 
of complex calculation. When you write your own 
functions, you are in effect giving the computer 
functions that its resident programming language 
(BASIC) doesn't already have - extending the 
capabilities of the language. 


Calculation sequences with functions 
Imagine that you want to calculate the cost of something 
that is sold by area — perhaps carpets to cover the floor 
of a house. You would need to multiply the length and 
width of each room to get its area, and then multiply 
that by the cost of the floor covering per square metre. 
If you called the length and width X and Y, and the cost 
per unit area C, then the cost per room would be worked 
out by (ХхҮ)*С, 

In the next program, the cost for each room is 
calculated by a function. It is defined in line 190, and 
used in lines 180 and 200: 


CARPET COSTER PROGRAM 
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„242 PAUSE 150; PAPER o BORDER 
` C >, 

150 PRINT AT 6 LENGTH: ха 
т ‚З; “утотне “ 

169 INPUT “соз PER SQUARE METR 
(170 PRINT AT 4,3; "COST PER SOUA 
RE METRE:s ic 

159 PRINT AT 12,3; "COST '; FN T 
(c) 

190 DEF FN Т (С) Ux v3) #С 

200 LET я=я+ғм TIC) 

210 PRINT AT 1+ ; “TOTAL созт- 
“за 

220 PAUSE 250 

23 GO TO 20 








Lines 20 to 130 set up a graphics display which 
produces an outline of the room, and then wait for you 
to ENTER values for length and width. Once you have 
done this, the program INPUTs the values and then 
clears the screen. 

The next display asks you for the cost per square 
metre of the floor covering. Once you have keyed this 
in, the program tells you what it would cost to cover the 
room. As well as using the function T to produce this, 
it uses it in line 200 to update a running total. If you 
keep keying in values every time the program returns to 
the first display, you will find that the TOTAL COST 
line in the second display will be updated to show the 
running total of all the costs calculated: 


CARPET COSTER DISPLAYS mul 





COST PER SQUARE METRE= 6.5 
LENGTHe 12.5 
УТОТН= 8 


coss 650 
TOTAL COST= 1750 





You can define a function at any point in a program, 
although if the DEF FN and FN lines are far apart in a 
long program, this will increase the program’s 
RUNning time. In the carpet coster program, using a 
function makes lines 180 and 200 less complicated than 
they otherwise would be. On page 33 you will see how 
using a function can make graphics far easier as well. 

































The BASIC keywords IF and THEN let a program 
operate in one way until the condition specified by the 
IF statement is encountered. When this happens, the 
program is then triggered to follow another course of 
action. But the capabilities of IF ... THEN do not stop 
at making a straightforward “yes” or “по” decision. Ву 
combining IF ... THEN with the keywords AND and 
OR you can make it tackle much more complicated 
situations. Because BASIC is designed to reflect how 
words are used in ordinary language, you can use 
IF ... THEN just as you would when describing a set 
of conditions to someone. Here is a program which 
shows how you can take IF ... THEN decision-making 
to a more advanced level: 
BOUNCING PROGRAM 
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Lines 10 to 130 simply set up the display - a black 
outline box in the middle of the screen. Lines 140 and 
150 produce a random starting position for a “ball” (a 
graphics square) inside the box. To make the ball 


EXTENDING 





DECISIONS 


appear to move, line 170 erases the image at r,c and lines 
180 and 190 produce new co-ordinates where line 220 
will rePRINT the ball. 

Before this happens, lines 200 and 210 check whether 
the ball has reached any of the box’s walls. ‘They 
examine the ball's position to see if the row number is 
one below the box lid or one above the box bottom, or 
if its column number is one more than the left side or 
one less than the right side. If any of these conditions is 
satisfied, lines 200 or 210 reverse the ball's vertical or 
horizontal motion, whichever is necessary: 








BOUNCING DISPLAY 








Adding decisions together 
You can now move on a stage further from the previous 
program to see how a second option can be incorporated 
in an IF... THEN statement. The next program 
features two balls moving independently: 

я: DOUBLE BOUNCING PROGRAM (1) 
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100 NEXT 
110 NEXT 
120 LET Г=5+ТНТ (RNỌO#12) 
190 LET s#S+iInT (RND#12) 
140 LET c=10+INT (RND#12) 
150 LET d=10+INT tRND 12» 
160 LET ani LET bz1 
170 ЕТ k=-1.3 LET tea 

RINT AT f "m 

T AT Кат: 















































This program is very similar to the first one, except that 
now there are two lines that PRINT a graphics square at 
changing row and column numbers. As before, each of 
the squares starts at a random co-ordinate which is 
defined in lines 120 to 150. The squares are then 
animated by lines 160 to 300: 


DOUBLE BOUNCING PROGRAM (2) 
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The second ball is made to set off in a different direction 
from the first and at a slightly faster vertical speed, so 
that the two balls have a greater chance of meeting. 
Otherwise, they would just follow each other around 
the box in the same tracks. Line 280 is the one in which 
the computer makes a multiple decision about the 
position of both of the squares. Without this line, when 
the squares met, they would just carry on through each 
other as if nothing had happened. This isn’t a very 
convincing simulation of what would really occur, so 
line 280 decides whether the squares are close enough 
together to have collided. The line includes an 
IF ... THEN decision with three ANDs to see if r and 
$ are sufficiently close together, and then if c and d are 
also within the same limits. It does this by taking r, for 
example, and then deciding whether it is greater or 
equal to INT(s+0.5)—1 and simultaneously smaller or 
equal to INT(s+0.5)+1. 

If all these conditions are met, then it means that the 
two balls are either occupying the same square or are on 
adjacent squares, in which case they can be assumed to 
have collided. A BEEP is sounded and the whole 
process starts again. 


IF ... THEN in games programming 
Decision-making by this method is very useful if you 
want to know whether or not two characters are 
occupying the same screen location. This is often used 
in program where a character is “shot down" by 
another. The next program shows how you can 
incorporate the technique in a simple game which has a 
number of characters moving simultaneously: 











FIRE-BASE PROGRAM 
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The program PRINTS а fire-base at the bottom of the 
screen. It fires upward arrows at two horizontal arrows 
that repeatedly fly across the screen. Line 130 checks 
whether the screen co-ordinates of the upward arrow 
are the same as those of either of the horizontal arrows. 
If they are, the program jumps right back to line 10 and 
begins again. If not, it jumps back to line 40 and moves 


all the characters on one space. Line 100 checks 
whether the upward arrow has reached the top of the 
screen. If it has, a new arrow is launched from just 
above the fire-base. Lines 60 and 70 check whether 
either of the horizontal arrows have reached the right 
edge of the screen. If either has, its column co-ordinate 
is reset to zero. 

When you RUN the program, you should find that 
the fire-base’s arrow finds its target on the horizontal 
arrows’ seventh pass across the screen. This happens 
because the program is working with fixed figures. If 
you use RND instead, the results become 
unpredictable and will change with each RUN: 
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FOR ... NEXT loops are very useful for repeating a 
sequence of program statements a predictable number 
of times. If you want to increase the value of a variable 
by more than 1 on every cycle through a loop, you could 
replace FOR... NEXT by a GOTO statement 
preceded by N=N-+2 or whatever change you want to 
make to N. However, if you have already started 
writing a program and then find that the standard 
FOR ... NEXT loop is unsuitable, it is sometimes 
awkward and time-consuming to substitute a 
completely new programming technique like this. 
Fortunately, there is a much more straightforward way 
of jumping forwards or even backwards in a loop. 


How to change jump sizes with STEP 
The BASIC keyword that deals with this is STEP, 
which you may already have come across in Book 1. 
Here is a program which uses STEP with graphics: 

—A GRAPHICS WITH STEP | 
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The graphics cursor is moved to each of the four corners 
of the screen in turn. A line is DRAWn from each corner 
to a point on the opposite side of the screen. The line 
separation is determined by the STEP size in line 20. 


STEP 4 gives the best results. This makes the values of 


y 0, 4, 8, 12, 16, and so on, instead of y increasing by 1 
in every circuit of the loop. 


Using STEP to DRAW grids 

One display that can be produced very easily using 
STEP is a games grid. You could make a grid just by 
DRAWing a series of criss-crossing lines against a 
contrasting background. But instead of specifying each 
line, you can use loops with STEP to do most of the 
work for you: 


GAMES GRID PROGRAM 
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Lines 20 to 50 DRAW a series of lines across the screen 
at vertical intervals of 21. Then lines 60 to 90 DRAW 
lines down the screen with a separation of 34. (The co- 
ordinates and line separations given here may be casier 
to follow if you refer to the graphics layout grid on page 
59.) 

Next is a program that will produce a games grid with 
as many squares as you like. The program asks you 
what sort of grid you want (how many squares across 
and down) and then feeds those numbers into a 
subroutine describing a generalized grid pattern. 

The program is divided into three sections. First the 
INPUT section (lines 10 to 100) asks you for the 
information necessary for the second half of the 
program. This takes the numbers you supply and uses 
them to calculate the separations of the lines DRAWn in 
the final display section (lines 140 to 240). It does this 


with two variables; w, which represents the number of 


squares across, is dividedi into the screen’s display panel 
width in line 130. In the same line h, the number of 
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squares from top to bottom, is divided into the height. 
With this program you can produce an almost endless 
variety of grids containing either squares or rectangles, 
depending on the figures keyed in: 

VARIABLE GRID PROGRAM 
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You can use this type of program as the basis for a chart, 
and then PRINT figures inside each square or 
rectangle. By using a technique which you will 
encounter on pages 22-23, you can then make the 
figures within the chart respond to different INPUTS. 


How to PRINT a chessboard 

To program the computer to PRINT a chessboard, you 
can PRINT alternate white and black squares, working 
your way down the board from top to bottom. It is then 
a simple matter then to add some colour to the display 
by introducing BORDER, PAPER and INK: 


CHESSBOARD PROGRAM 
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Here PRINT AT is used to build up rows of dark blue 
squares over a cyan background. The program selects a 
blue foreground colour (INK 1) and sets the row co- 
ordinate to the top line of the board. Having PRIN Ted 
one blue square, it skips the second one, leaving it cyan, 
and PRINTS a blue square in the third position. The 
column STEP size is set to 4 to deal with this. As each 
loop draws two rows of squares, the row STEP size of 4 
skips every other row. 
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To key in new information while a program is RUNning 
you have — until now — used the command INPUT. 
With INPUT you must press ENTER after keying the 
information in. This technique has its disadvantages. 
Even when you know that it's necessary to use ENTER, 
you can occasionally forget, and using two keys in 
sequence also slows programs down. It is much more 
useful if the computer responds without waiting for you 
to press ENTER, just as arcade machines respond 
every time you press a control button. To make the 
Spectrum do this, you can use the keyword INKEY$. 


ASCII codes 
Keywords, numbers, letters, punctuation marks and 
mathematical symbols — in fact, all the symbols that the 
computer recognizes — are stored inside the computer as 
numbers from 0 to 255. Most computers, including the 
Spectrum, store these numbers according to a code 
called the American Standard Code for Information 
Interchange (ASCII). So, every computer that uses the 
ASCII standard stores a letter A as the decimal number 
65, a “+” sign as 43, and the decimal number | as 49. 
(A complete table of ASCII codes is shown on page 60.) 
You can see all the characters that the Spectrum uses 
by keying in a very simple program: 
10 FOR n=33 TO 255 
20 PRINT CHR$ n; 
30 NEXT n 
This makes the computer take each ASCII code in turn 
and then PRINT the character that the code represents, 
missing out the initial “blanks” and control codes: 
SPECTRUM CHARACTER SET. Е 
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You can see from this that some codes represent just one 


letter or number, whereas others represent complete 
BASIC keywords. 























'The next program uses INKEYS to respond to keys as 
they are pressed, and then uses ASCII numbers to 
PRINT in a simple code: 

kT: ENCODER PROGRAM 





PRINT AT 5,10; "ТҮРЕ ENCODER 


‘ THEN GO TO гә 
„THEN GO TO за 








Line 10 PRINTS the title and lines 20 and 30 use 
INKEY$ to wait for you to release a key before 
continuing. Line 20 may puzzle you. Change it to: 


20 REM IF INKEY$—-'" THEN GOTO 20 


so that it doesn't work. You should find it impossible to 
press a key and get a single character on the screen. 
Unlike INPUT, INKEYS doesn't wait for you = it 
checks if any key has been pressed and then moves on to 
the next line. So line 20 keeps on being carried out until 
you release a key, then line 30 keeps on RUNning until 
you press the next key. 

Line 40 then tests the keyed character to see if it is an 
asterisk. If it is, the program ends. If not, line 50 
converts your character into its ASCII code. Line 60 
adds 2 to the code for the key you have pressed and then 
PRINTS the equivalent character. So, the program 
appears to PRINT nonsense when you key something 
in. There's no point in producing a coding program if 
you can't crack the code. You can quickly turn the 
encoder program into a decoder by inserting: 

10 PRINT AT 5,10; TYPE DECODER” 

60 PRINT CHR$(n- 2); 

'To see if it works try keying in the following when the 
program is RUNning: 

ngctp*vq"rtqitco*ykvj" vjg^FM"uetggp"ujqv ugtkgu 
Testing your reactions with INKEY$ 


You can use INKEY$’s ability to check the keyboard in 
combination with ASCII codes to write a program that 


















enables you to time the speed of your reactions. 

This program produces a random symbol on the 
screen, and then times how long it takes you to press the 
symbol it has selected: 
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Lines 10 to 50 PRINT the title frame and PAUSE for 3 
seconds. Then the game begins. Line 70 sets k equal to 
a randomly generated number between 33 and 127, the 
ASCII code numbers for the Spectrum's letters and 
symbols (this excludes the graphics symbols and 
keywords). Line 70 also sets n equal to zero — n is used 
later to work out the time taken to press the correct key. 
Line 80 makes a sound to signal the beginning of the 
timing period. Line 90 PRINTs the character 
equivalent to the random code found by line 70. Line 


110 checks whether you have pressed the correct key. If 


not, it cycles back to line 90, and on each loop, n is 
increased by 1. 

If you do press the correct key, the time elapsed since 
the BEEP is calculated by (IN T(n*2.68))/100 seconds. 
If you want to know why this is the line to use, try 
inserting the following line: 











105 IF n=1000 THEN BEEP 0.3,20 


in the program. This lets you time 1000 loops with your 
watch. They should take roughly 26.85 seconds, so 
each loop takes 0.02685 seconds. To find the elapsed 
time, multiply n by 0.02685. To limit the time 
PRINTed by line 130 to two decimal places, multiply 
(п*0.02685) by 100 (=n*2.685), take its integer value 
(to get rid of all figures after the decimal point) and 
finally divide the result by 100. 


Using INKEY$ to control movement 
INKEYS's quick responses make it ideal for controlling 
movement on the screen. In the following program, 
instead of going through a predetermined series of 
movements, the computer waits until either the Z or M 
keys are pressed and then moves the character left or 
right respectively. Lines 170 and 180 stop the character 
being moved beyond either side of the screen: 
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If you RUN the program, you will find that the 
character responds only to keys Z and M. 




















RANDOM NUMBERS AND ODDS 





The Spectrum has two separate keywords which both 
deal with random numbers - RND апа 
RANDOMIZE. As you have already seen, RND is 
used to generate random numbers. A line like this: 


80 LET a=RND 


will produce a random number between 0 and 
0.99999999, 

Actually that's not quite true. The Spectrum has a 
sequence of 65,536 different numbers between 0 and 
0.99999999 stored in its memory. They are all mixed 
up, so that there is no obvious pattern. Because of this, 
RND is said to be a “pseudo-random” function. There 
is a sequence behind the numbers, but for most 
purposes the numbers can be taken as completely 
random. Although a number between 0 and 0.99999999 
isn't much use, a line like the following produces whole 
(integer) random numbers in other ranges: 


100 n=1+INT(2*RND) 


Here the line produces a | or 2, for a coin toss program 
perhaps. 2*RND produces a number between zero and 
1.99999998, INT rounds that down to the next lowest 
integer (0 or 1), and 1 is added to this to produce a 1 or 
2. In the same way: 


100 n=1+INT(6*RND) 


produces numbers between 1 and 6. 


How to start a “random” sequence 

Debugging a program that uses RND can be difficult, 

because no two КОМ of the program produce the same 

result. It is easier to find the errors if the RND 

statements are made to produce the same numbers each 

time the program is RUN. First type in: 
RND PROGRAM 








PRINT RT 
NUMBERS" 
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This very simple listing produces a series of six random 
numbers. Each time you RUN the program you should 
get a different series of numbers. The first screen below 
however produces a series which is always identical. It 
is programmed by adding: 

125 RANDOMIZE 10 

By using the keyword RANDOMIZE (which appears 
as RAND on the keyboard) each RUN produces the 
same numbers. This command works in a simple way — 
by controlling where RND starts selecting from its 
store of 65,536 numbers: 


RANDOM/REPEATING DISPLAYS 
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The second screen shows what happens when you move 
RANDOMIZE. Using the screen editor, change line 
125 to line number 135 and delete 125. Now you should 
get the same number (0.17602539) every time. 
RANDOMIZE 10 starts the random sequence off at the 
tenth stored number on each RUN. You can follow 
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RANDOMIZE with any number between 1 and 
65,536. RANDOMIZE on its own uses the time since 
the computer was switched on to set the starting point 
for RND. So, using RANDOMIZE with RND makes 
RND even more random! 


Setting odds in adventure games 
Whatever you do with RND, it only produces one 
number at a time. "That's fine for coin-tossing or dice 
programs where each of the possible results (heads or 
tails, fof instance) is as likely as any other result. But 
imagine you want to build probability into a program, 
so that some results are more likely than others. This is 
how many adventure games are written, making the 
programs much more interesting than ones that deal 
with predictable sequences of events. 

The following program does this. It demonstrates 
how, in an adventure game, you can make it likely that 
the player.will encounter some characters or symbols 
more frequently than others. You can also set the odds 
so that more often than not, nothing happens: 
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300 FOR п=1 TO 100 

910 LET а-ІЫТ (204RNO+1) 

320 IF а=1 THEN LET пз- "ав LE 
T Әйе"“СО“: LET 15141 

339 IF аср OR as23 THEN LET AS= 
ЕГ“: LET В8е" СН“: LET kakti 

340 IF а=4 OR às5 THEN LET Age 
IJ": LET B9s5s"KL' LET dsd41 

359 IF a»5 THEN LET Яя“: LE 
Т Вве"а+" 

360 PRINT AT 10,16; A$; ат 11,16; 
въ 

379 PRINT AT 12,5;1; ВТ 12,16;к; 
AT 12,26;4; AT 17,15;n 

900 ВЕЕР 0O.2,15 


390 NEXT n 





Lines 10 to 230 reprogram the keys A to L with the 12 
characters that make up the three game symbols — a bag 
of treasure, an armoured knight and a dragon. Each 
symbol is made up from four characters, the first two 
above the second two. 

Line 310 produces a number between 1 and 20. If it 
equals 1, then the treasure symbol is selected. If it 
equals 2 or 3, the knight is selected and if it equals 4 or 
5, the dragon is selected. If it equals anything else, 
nothing (represented by four asterisks) is selected. So, 
a knight or a dragon are twice as likely to appear as a bag 
of treasure. 

When you RUN the program, 100 random selections 
are made. The running totals of treasure, knights and 
dragons are shown building up on the screen. You can 
change the relative probabilities of the three symbols 
appearing by changing the numbers in lines 320 to 350. 
Inserting a PAUSE statement in the loop, or increasing 
the duration of the BEEP in line 380, slows the program 
down. By the end of each RUN, you can see how often 
the program has chosen each of the characters: 
Xj ADVENTURE ODDS DISPLAY 
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The following direct command will produce a circle on 








On many personal computers, drawing curves and 
circles is quite an involved process. The Spectrum 
makes drawing circles very easy — its CIRCLE 
command does all the mathematics that you would 
otherwise have to do yourself. To produce a circle, all 
you have to do is specify the co-ordinates of the point at 
the centre of the circle — x and y, and the length of its 
radius, r. This lets you produce any size of circle in any 
position, within the limits of the graphics grid. 





Any circle can be produced with the command CIRCLE x,y,r 
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the screen: 

CIRCLE 128,88,50 

The centre of this circle is at the centre of the screen 
(128,88) and it has a radius of 50 units. So, the 


horizontal diameter goes from 78 to 178 units across the 
screen and the vertical diameter from 38 to 138 up it. 


Producing patterns with CIRCLE 
You can use the CIRCLE command to make up 
patterns by selecting the co-ordinates of a circle’s centre 
at random. Here is a program that builds up a display by 
this method: 

~ CONCENTRIC CIRCLES PROGRAM 











CONCENTRIC CIRCLES DISPLAY 


Lines 30 and 40 produce a pair of x and y co-ordinates 
at random so that neither is within 50 units of any of the 
screen edges. It is set like this because the program will 
then draw concentric circles up to a radius of 50. The 
loop at lines 50 to 70 repeatedly draws circles with the 
same centre but with gradually increasing radii (r). Line 
80 starts the whole process off again but with a new pair 
of random co-ordinates. 

You can change the maximum radius of the circle and 
the STEP size between radii by changing line 50: 


50 FOR r=10 to 20 STEP 3 


or even STEP 2, which produces smaller patterns. 


Drawing arcs and waves 

An arc (part of the edge of a circle) can be produced on 
the Spectrum's screen, but you cannot use the CIRCLE 
command to do this. But adding another number to the 
DRAW command — making it DRAW x,y,a - DRAWs 
an arc of a circle, starting from the last point PLOTted 
or DRAWnA to, and finishing at a point specified by x,y. 
The “а” value is more complicated. This is the angle 
that the arc turns through (if you imagine it as being 
part of a circle). You can see the command at work if 
you key in these two lines (you will find the keyword PI 
above the M key): 


PLOT 10,88 
DRAW 230,0, PI/4 


This produces a display like a piece of rope suspended 
at both ends and sagging in the middle. The first 
statement PLOTS a point near the left edge and halfway 
up the screen. The DRAW statement then DRAWs ап 
arc from that point in an anticlockwise direction to 
(10--230),(88--0) or 240,88. 





АРИР кн RR M —|— m ee ve METER m M OOO 














Whether the are forms a shallow sag or a semicircle is 
determined by the size of “а”. This angle is measured 
not in degrees but in radians. Radians are simply an 
alternative way of measuring angles based on the 
geometry of a circle. A complete circle is produced by 
turning around through 360 degrees. That is exactly 
equivalent to 2*PI radians. PI is an important 
mathematical constant, which has a value of 
3.14159625 ... (you can see this by keying in PRINT 
PI). It is the ratio of the length of the circumference of 
a circle to its diameter. There are 2*PI radians in a 
circle. PI/2 radians are therefore equivalent to a quarter 
of a circle (90 degrees), PI/4 radians are equivalent to 
one eighth of a circle (45 degrees) and so on. 

Now, without erasing the first arc, try adding: 
PLOT 10,88 
DRAW 230,0, — Р1/4 
The second arc is DRAWn between the same two points 
to form an eye-shaped figure. You can build up shapes 
using arcs to produce wave-like patterns: 

2 WAVE PATTERN PROGRAM 
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FOR x#® 22 30 
PLOT х,ч 
DRAW 15,0,P 


Ө NEXT x 
LET yey 
NEXT f 


DRAW 15,0,- 











Line 20 sets the first y co-ordinate value of the waves. 
Line 40 STEPs the x co-ordinate across the screen. It's 
important that the STEP size is the same as the 
combined x lengths of the two parts of the wave formed 
by each loop. Line 50 PLOTS a point at the x,y co- 
ordinates set at the beginning of each loop. Line 60 
DRAWS a small arc of a circle and then it goes on to 
DRAW a second arc of the same size. The first arc sags 
downwards, the second upwards and so on, building up 
a row of waves. When that is complete, line 80 moves 
the y co-ordinate downwards. The program continues 
until the waves reach the bottom of the screen. 


Programming creeping curves 
On the previous page CIRCLE was used to produce 
concentric circles at random. Here is a program that 
DRAWs semicircles, also at random, each of which goes 
up, down, left or right, to creep over the screen: 

CREEPING CURVES PROGRAM k 
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Try changing the arc size in lines 50 to 80 for different 
effects. You'll find that if you reduce the arc size to 4, it 
looks more like a letter v. 

















Most of the shapes you have DRAWn so far have 
involved working out beforehand where the key points 
of the shape (the corners of a square, for example) 
should lie, and then DRAWing lines between them. 
Fortunately, much more complicated geometrical 
patterns can be DRAWn by using functions that do all 
the work for you. You don’t have to PLOT a single 
point. Using the functions SIN (short for the 
mathematical term "sine") and COS (short for 
“совіпе”), you can produce some spectacular graphics 
with quite short programs. 

All of the programs on these two pages use a 
combination of SIN and COS, so it’s worth trying to 
understand what these commands actually mean. 


Another way to PLOT circles 
On page 16, you saw how the command CIRCLE can be 
used to produce a circle. You can actually PLOT a 
circle by another method, using SIN and COS. 
Although the program is longer, it then enables you to 
branch out into some much more elaborate graphics. 
If you sketch out part of a circle, you can relate each 
point on the circle to an angle at the circle's centre. 


Point on circle 


Radius length=r 


е 


Horizontal distance=x 


The distances x and y can be expressed in another way, 
as multiples of the angle and SIN or COS. Every angle 
has its own value of SIN and COS, and the co-ordinates 
of any point on the circle can be written as: 


rx*COS(a),r*SIN(a) 


Once you know this, you can get the computer to 
PLOT a circle. By working through all the possible 
values of the angle “а” with a loop, a program can use 
the functions SIN and COS to PLOT the co-ordinates 
of every point on the circle. 

You can, of course, do this much more easily by using 
CIRCLE. However, if you key in the next program, 
you can develop it to produce graphics that CIRCLE 
itself cannot produce. Line 20 sets the radius of the 
circle to 80. The angle has to vary from zero to a full 
circle (360 degrees): 
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Because the BASIC functions SIN and COS operate on 
angles measured in radians, like the command DRAW 
X,y,a on page 16, the range of the angles again uses the 
keyword PI. The STEP of PI/120 (line 30) is chosen so 
that the dots are relatively close together but the 
program doesn’t take too long to RUN. 


Patterns with SIN and COS 
The circle program, above, produces a circle because 
the x and y co-ordinates vary exactly out of step with 
each other. When x is zero, y is at its maximum value 
and vice versa, What would happen if you varied x and 
y at different rates? Try altering the angle after the SIN 
command. Here the angle has been doubled in the first 
display, and multiplied by five in the second: 

> “LISSAJOUS” FIGURE - SIN (2ха) 








The number of loops in each display depends on how 
many times the angle after SIN has been multiplied: 
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| “LISSAJOUS” FIGURE - SIN (5*a) 


Complex curves 
Now you can make a different sort of change: 
KIDNEY PROGRAM x 
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50 NEXT a 























In this program, the colours and STEP size have been 
changed as well as the co-ordinate values. The program 
will continue DRAWing if you increase the range of 
angle values. The next program roughly doubles the 
range. It also accelerates the RUNning speed by 
DRAWing short lines instead of PLOTting individual 
points as in the CIRCLE program opposite: 












HOURGLASS PROGRAM 


BORDER 
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You can experiment with this program to produce a 
whole variety of more complicated shapes. The next 
design is produced by changing the colours and lines 40 


and 50 to: 


40 FOR а=0 TO 1000 STEP 0.1 

50 LET i-r*xCOS(a)*SIN(0.98xa) 

The shape starts off by being quite open but eventually 

the program fills in the circle (this screen shows it after 

half an hour of RUNning): 
H BALL DISPLAY | 





You may find with this type of program that the 
graphics resolution cannot cope with too much detail 
as every curve has to be shown as a series of dots. 
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THE COMPUTER CLOCK 





Time delays are among the most frequently used 
commands in computer programs. One of the problems 
of working with a micro is that it often RUNs through 
programs too quickly. Time delays slow programs 
down to a speed that is useful. A delay may keep some 
text on the screen for a moment, long enough to read it, 
before it disappears and the program continues, or it 
may slow down an otherwise too rapid sequence of 
images — in an animation program for example. 

The quickest and easiest time delay to write into a 
program is the PAUSE statement. It takes the form of 
the following program line: 


100 PAUSE 50 


where the number after PAUSE represents the time 
delay in fiftieths of a second. It’s a simple matter to 
RUN a program containing the above PAUSE 
Statement and see for yourself if the delay is long 
enough. If not, then increase and test the number 
following PAUSE again. It’s approximate, but 
convenient. However, if you want to time an event in a 
program you can use a clock that has been built into the 
Spectrum itself. 


Using the internal clock 

Some computers have a timing facility, a clock that runs 
regardless of whatever the user's programs are doing. 
The Spectrum doesn't have any command or function 
that enables you to use a timing facility with a single 
program statement. 

However, in common with every other personal 
computer, the Spectrum has an internal clock which 
synchronizes its activities. Linked to this is a counting 
device. Three “addresses”, or slots, in the Spectrum's 
memory count the number of television pictures (or 
frames) that have been produced since the computer 
was switched on. The first address (numbered 23672) 
counts frames up to a maximum of 255. Then it is reset 
to 0 and the contents of the next address (23673) are 
increased by 1. When that reaches 255, it is reset to 0 
and the contents of the third address (23674) are 
increased by 1. Because, in Europe, television pictures 
are produced at the rate of 50 per second (the rate is 60 
per second in the United States), the first address 
(23672) in effect counts in fiftieths of a second, the next 
address in 5.12-second intervals and the third address 
in 1310.72-second intervals. 

If this internal clock/counter is only accurate to a 
fiftieth of a second, you might wonder what the 
advantage is of using it instead of the much more 
convenient PAUSE statement, which has roughly the 
same order of accuracy. The reason is that PAUSE is a 
BASIC statement which makes up part of a program. 








The program is unable to do anything else during the 
PAUSE. It can never be more than a temporary 
interruption to the program. 

The frame counter works in a different way. It keeps 
on counting whatever the program is doing — with two 
exceptions. If you make the computer BEEP or you use 
any piece of hardware connected to the computer – a 
cassette recorder or printer, for example — the frame 
counter stops while you are doing so, and then resumes 
its count. So, if you want to use the frame counter as a 
clock, it would lose time during these operations. 


Timing with the frame counter 
To see the frame counter working, try keying in the 
following two lines: 


10 PRINT PEEK 23672 
20 GOTO 10 


The screen should fill up with increasingly large 
numbers (up to 255), until the "scroll?" prompt 
appears, as shown on the display: 


FRAME COUNTER DISPLAY 
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PEEK looks into the address specified to see what 
number is stored there. It’s the counterpart of POKE, 
which puts a number into an address. PEEK 23672 
means “the contents of” address number 23672. Note 
that the numbers PRIN Ted aren't consecutive. There is 
a difference of three or four between each pair. That's 
because the PRINT and GOTO statements themselves 
take some time to be carried out, so the program isn't 
able to “catch” every single fiftieth of a second “tick” of 
the frame counter. That can cause problems when you 
want to use the frame counter to count in small time 
intervals, as you can see from the following program. 
When you RUN it, a BEEP should sound every second. 
The variable t is set equal to the contents of 23672: 




















FRAME COUNTER “CLOCK” 


БФ THEN SEE 





When the difference between the PEEK 23672 and the 
fixed t reaches 50, then one second has passed and the 
BEEP should be sounded. 

Unfortunately, as you probably discovered, when 
you RUN this program, it hardly produces more than a 
couple of BEEPs. The trouble is that PEEK 23672-t is 
unlikely to be equal to 50 at the instant when line 20 is 
being carried out. Also, the BEEP statement stops the 
frame counter for a twentieth of a second every time it 
sounds. This sort of program can be used as a timer, but 
the time interval (the time between ticks) must be large 
compared to the time taken to carry out the program 
statements. 

The next program times a 5-second interval, 
although it is not completely accurate. The second 
address counts every time the first address is full — that 
is, every 256 fiftieths of a second, or 5.12 seconds. That 
is adequate for a timer that only has to be accurate to the 
nearest minute or half minute. Line 10 resets the 
address to 0 every time the program is RUN: 


5-SECOND TIMER 








tsPEEK 23679 


PEEK 23673>t THEN PRINT 


TO зо 












Using time in programs 
Because PEEKing the frame computer requires a 
number of calculations, you can substitute a function 
EN t() to represent the number of seconds that have 
elapsed since the computer was switched on. A variable 
T is set equal to this, and, later in the program, when 
EN t() exceeds T, the seconds display is increased by 1. 
T is then reset to FN t() for the next count. A program 
can also incorporate tests to increase the minutes and 
hours displays when necessary. 

This relatively accurate timing is of more value in 
programs. Here is an example of one way to use it, in a 
program that times the speed of your reactions: 
ТЕЛІ 777 REACTION TIMER 
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The time function FN t() is defined in line 10. It PEEKs 
all three frame counters. The final division by 50 is 
omitted, so that the function counts in fiftieths of a 
second, instead of in seconds. Line 50 causes a random 
delay of at least 2 seconds before the timing period 
starts. Line 80 waits until you press a key before 
clearing the screen (line 90) and then calculating and 
PRINTing your reaction time. 
























An array is a way of storing facts and/or figures in the 
computer’s memory in the form of a table, so that you 
can locate any one item in the table without having to go 
through all the others first. Each item in an array is 
specified by one or more numbers. In the following 
array, each item is given a pair of co-ordinates which 
identify it and nothing else: 


1 2 3 4 5 6 
1 FRED KATE JOHN JANE ALAN JUDY 
2 100 250 840 125 223 691 


This is a 6X2 array, so-called because it has 6 columns 
and 2 rows. Item (2,2) is 250, item (1,3) is JOHN, and 
so on. Because two numbers are needed to identify each 
item, this array is known as a two-dimensional array. If 
it was composed of only one row of names or numbers, 
it would only need one number to identify each item 
and so it would be called a one-dimensional array. The 
BASIC keyword DIM is used to tell the computer how 
big an array is to be. 


A one-dimensional array can be used to store a list of 


frequently used numbers or strings: 
ONE-DIMENSIONAL ARRAY 











Here line 20 tells the computer that the array m$ is 
12x9 entries (9 is the maximum number of letters in the 
name of any one of the 12 months). The program 
PRINTS out the list of the months of the year given in 
line 10. Although there are easier ways of doing this, 
later on in a program, you might want to match up a 
month with other information or the result of 
calculations. Using this listing, you can pick out any 
month by using m$(n) where n is the month number. 
When the program is RUN, the display it should 











produce looks like this - a month chart ready for more 
information: 
= ONE-DIMENSIONAL ARRAY DISPLAY 
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How to add а dimension 
Now you build upon the calendar array program to 
make it do something useful. Add a second array, a 
numeric array, so that you can list some values against 
each month. The following program uses the array to 
represent monthly rainfall totals. 

The table now has two headings. You don’t have to 
PRINT all the members of the string array — m$(n) - 
before moving on to select the numeric array - r(n). 
Line 80 takes one item from each array. As these are to 
be PRINTed on consecutive rows of the screen, they 
can easily be identified by relating them to the row 
number. For each value of n, m$(n). and r(n) are 
PRINTed at different column numbers of row (5+n): 


TWO-DIMENSIONAL ARRAY 
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TWO-DIMENSIONAL ARRAY DISPLAY 





















MONTH RAINFALL (cms) 
January 2.5 
Februaru 1 
March 2.5 
April 7.5 
May 9.5 
June 4.5 
Ju ty 3.5 
August 4 
September 4.5 
October 4.5 
November 4 
December 2.5 












Writing tables with arrays 
You can now make a table that is more ambitious: 
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In this financial planning program, the columns are 
interrelated and you have the option of changing some 
of the information displayed, should you need to do so. 

Line 10 contains the DATA for the first part of the 
array, a series of prices, and line 20 the DATA for a 
second part — a series of quantities. Line 20 also 
contains some co-ordinates which will be used later in 
the program. Lines 40 to 90 dimension the 9х2 array 
and READ in its DATA. Lines 100 to 170 simply 
DRAW the grid of lines that frames the DATA. The co- 
ordinates of the bottom end of the vertical lines in the 
grid are stored in line 20. Line 180 PRINTs the column 
headings. 

The DATA is PRINTed in the grid by lines 190 to 
220. It is to be PRINTed every other line from rows 3 to 
19. The number of the item, n, (from | to 9) is related 
to this by: 


row=24n+1 


and this appears throughout lines 200 and 210 in the 
PRINT AT statements. The last two items in line 210 
look particularly complex. If the subtotal was 8.25, the 
tax would be calculated as 0.15*8.25=1.2375 - too 
many decimal places. To solve that, the tax is multiplied 
by 100, the INTeger value of it is taken (removing all 
the decimal places) and it is divided by 100 again. The 
0.005 is added to ensure that the final figure is rounded 
down to the nearest unit. 

Lines 240 to 260 invite you to enter a new tax rate. If 
you do and press ENTER, all the figures in the table 
that use the tax rate are recalculated. This instant 
recalculation facility is the principle behind a type of 
financial planning program called a spreadsheet. Inter- 
related columns of figures representing income, raw 
material/production costs, overheads and so on can be 
entered. Then the effects of changing one or more of 
these parameters can be observed as all the totals are 
recalculated throughout the display: 


TAX TABLE DISPLAY 











ТТЕМ | СО5Т 
1 1.96 
2 2.4 
























Almost every program you have looked at so far has 
taken numerical data and performed some calculations 
to arrive at a result. But the strings used have almost 
invariably been left in their original order. However, as 
you saw in the reaction test program on page 13, the 
computer stores letters as well as numbers as ASCII 
codes (a table of the Spectrum’s ASCII codes appears on 
page 60). Because these codes have numerical values, 
the computer can examine strings and then reorder 
them in a similar way to numbers. 


How to rearrange numbers 

To see how words — or any strings — are sorted or 
reordered, it's helpful if you understand how the same 
thing is done with numbers. Here is a program which 
asks you for six numbers, and then rearranges them in 
numerical order. You could easily extend it to deal with 
many more numbers: 


NUMERICAL SORTER PROGRAM 
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Line 50 asks you to type in a one- or two-digit number. 
Each time you do this and press ENTER, the next 
prompt (from | to 6) is PRINTed above the next 
INPUT position. This is where your chosen number 
will be PRINTed by line 60. All the numbers you 
ENTER are loaded into an array, so that they can be 
tagged with a number to identify them. 

After you have ENTERed six numbers, the sorting 
procedure begins automatically at line 80. First look at 
the n loop (from the second statement in line 80 to line 
100). For each value of n, a(n+1) is compared to a(n). 
If a(n+1) is the smaller, line 150 reverses them. So, on 
the first pass round the loop (n=1), if your first two 
numbers were 34 and 16, the reversal subroutine would 
be called, because the second number is smaller than 
the first. It would set b equal to a(1) — 34 in this case - 
set a(1) equal to a(2) - 16 here — and finally set a(2) equal 











to b, which on this loop is equal to 34. This juggling 
reverses the two numbers. The maximum number of 
sortings needed to put the list of numbers into the 
correct numerical order is five, so the t loop repeats the 
sorting process 5 times. These screens show the 
numbers before and after sorting: 


NUMERICAL SORTER DISPLAYS 
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Statement, 140.2 


This reversal process can be used to manipulate strings 
in the same way. It’s easy to see how the computer can 
compare two numbers and test whether the second is 
smaller than the first. We do it ourselves all the time - 
when comparing prices for example. But the computer 
can also decide whether *London" is less than *New 
York" — that is, whether one comes before the other in 
the alphabet. A line like: 


50 IF “New York" —*London" THEN GOSUB 300 


doesn't seem to make much sense at first glance. But 
because the computer stores a string like New York or 


























London as a series of numbers, these numbers can be 
compared and reordered. So comparisons like a<b and 
Stockholm>Paris both make perfectly good sense in 
BASIC. 


Rearranging in alphabetic order 

One of the most useful applications for string sorting is 
rearranging into alphabetic order. The following 
program shows one, method — it works on strings 
already built into the program, but you can easily adapt 
the program to accept different strings by using 
INPUT: 





ALPHABETIC SORTER PROGRAM 


DATA “Рагъз"," 
york","*London"," 


чаю 
20 DIM am$(6,9) 
30 FOR nsi TO 
EXT 


READ asin) 
“Atpha sort 


<ā$(n) THEN GO 50 


веррвревне 


Line 20 dimensions a string array using the method 
demonstrated on page 22. Line 30 then READs the 
contents of line 10 — a series of capital cities. The 
subroutine at lines 120 to 140 PRINTS the cities in their 
original order. Then the sorting routine moves the 
strings around until they are in alphabetic order. You 
could add a PAUSE to slow things down so that you can 
actually follow what is going on: 


ALPHABETIC SORTER DISPLAYS __ 


Atpha sort 1 
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Alpha sort 2 
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9 STOP statement, 110.2 


The sorting routine at lines 150 to 180 is basically the 
same as that used to sort numbers. The variables used 
here are of course string variables, but the computer 
uses the same mathematical comparisons as it uses 
when operating with numbers. The program then 
STOPs at line 110. 

Note that the temporary store used in both the 
number and string reordering programs (b and b$) need 
not be an element of an array. The variable is only used 
once on each sorting and then is not required again. 


How to turn strings into numbers 

The Spectrum uses a number of keywords which enable 
it to use numerical information from strings. In 
addition to taking string characters and comparing their 
ASCII values, the computer can decide how long a 
string is. To program this, you need to use the keyword 
LEN. The following program line for example 
produces a number: 


100 n=LEN“Spectrum” 


Here n is equal to 8, the LENgth of the string. You can 
use this in programs to reject an INPUT word or name 
that is too long, or make the computer take different 
courses of action depending on how long certain strings 
are. You can add LENs together to find out the length 
of a number of names or any other piece of text. 

The Spectrum also has a keyword which operates on 
strings that are themselves numbers. VAL coverts a 
number-string containing a calculation into a number. 
'The number produced by this is itself the result of the 
calculation. For example: 


150 LET а$=“2*34.5*0.3” 
160 PRINT a$;*—";VAL a$ 


PRINTS both the calculation and its result — a useful 
programming technique. You can use this command to 
evaluate a string and then pass this value on to another 
part of a program. 
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Until now, you have treated strings - or words that 
make up strings — as indivisible units. Some of the 
programs so far have added strings together, but none 
of them have “looked inside” the quotation marks that 
begin and end every string to work on the characters 
that are there. With the Spectrum you can take strings 
apart and reassemble their characters in a number of 
different ways. This means that you can program the 
computer to take out part of a word or group of words 
and examine it — a process that can be very useful. 

Most computers that work with BASIC have a family 
of commands that can be used to manipulate strings — 
LEFT$, RIGHT$, MID$ and so on. They are used to 
pick out the first, last or middle character of a string 
respectively. Although the Spectrum doesn't have any 
of these commands on its keyboard, it can do 
everything that these commands do, if you know how to 
program it. 


How to cut up words 
You can make the Spectrum break into a word by 
slicing parts off the string. It's fairly straightforward. 
'To see how to do it, first type in the listing on the 
following screen: 

STRING SLICER PROGRAM 





Spectrum 
зе CLS 
ЭЙ FOR пез TO 31 
40 PRINT ав: ) 
59 NEXT n 


10 LET зва" За < 
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The special technique here is in line 40, where a ТО 
command appears as part of a string variable. For each 
value of n, line 40 PRINTs a string n characters long, 
from the first character to the nth character. So, the first 
line contains the string “S”, the second line “SI” and so 
on, until n equals the length that is set. With this 
program you can use any string — a group of words, 
numbers or other symbols; it’s best if the value of n is 
not more than one screen line (32 characters). If you use 


a different string, make sure that the maximum value of 


n in line 30 is no more than the length of your string: 

















STRING SLICER DISPLAY 
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You can use this kind of technique to pick out strings 
that all begin with the same letter or word, and then 
perhaps PRINT them out in a series of lists. 

'The reverse effect is just as easy to produce. Try 
adding the following lines to the program, then RUN it 
to see what happens: 


60 FOR n=1 TO 31 

70 PRINT a$(TO 32- n) 

80 NEXT n 

Now, as n increases from 1 to 31 on each loop, the 
length of the string PRINTed decreases from 31 
characters to only 1. 


Picking out parts of a phrase 
Now you can explore this technique. Type in and RUN 
the listing on the following screen: 

SELECTIVE STRING SLICER PROGRAM 
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You aren’t limited to dealing with the first n characters 
of a string. In fact, you can take any consecutive group 
of characters from a word or sentence. In this program 
line 50 works in the same way as line 40 of the slicing 
program. Line 60 forms a string from characters 4 to 14 
out of the middle of a$. Finally, line 70 forms a third 
string from character number 15 to the end of a$. 
Although these three “substrings” are formed from 
parts of a$, a$ itself is still intact. This technique lets 
you take a group of words and pick out any of them for 
use on their own in a program. 


Word games with string commands 

The next program shows how you can use these 
methods of handling words in a game. Its a 
computerized word-guessing contest in which one 
player enters a word and the other has to guess it; the 
computer PRINTS the letters that the user has guessed 
correctly in their right positions in the word: 

“HANGMAN” PROGRAM 
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Lines 10 to 50 PRINT the title frame. When a friend 
has typed in the test string that you will have to guess, 

















line 70 calculates the length of this test string using the 
command LEN, and sets the score, s, to zero. 

The program now has to PRINT symbols on the 
screen to represent the letters in the test string. As you 
guess the letters, any correctly guessed letters will 
replace these symbols. Also, to allow for test phrases 
rather than just words, the positions of the spaces 
between the words are shown. Line 100 PRINTs 
hyphens to represent the characters. Line 90 PRINTS 
black squares to represent any spaces in the test string. 
In lines 90 and 100, (32—1)/2+n works out where the 
characters that represent the test string should be 
PRINTed so that they lie in the middle of the screen, 
not off to either side (a similar effect is incorporated in 
commercial word-processing programs). 

If you want to guess the whole word or phrase instead 
of keying in individual letters (you can do this at any 
point in the game), press 1. The program jumps to line 
210. The word or phrase that you type in (t$) is 
compared to the stored string (a$). Then a 
“CORRECT” frame is PRINTed or if the guess is 
wrong, the program returns to single letter entry. When 
a single letter is tried, lines 170 to 190 compare it to each 
character of the stored string in turn. If the guess is 
correct, the letter is PRINTed in the appropriate 
position in the display. Here is an example of the 
display you should see when a game is in progress: 

“HANGMAN” DISPLAY 
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You can easily limit the number of guesses by adding 
the commands: 
IF s>n THEN STOP 


after the statements where the score, s, is calculated. If 
you should make a mistake when using the program, it 
can be difficult to interrupt using the shifted BREAK 
key, so to make this easier, add one extra line: 

145 IF t$=“3” THEN STOP 


To stop the program at any point, simply press 3. 














You can use your Spectrum to store information, rather 
like an electronic filing cabinet. However, it would be 
time-consuming if you had to display the complete 
contents of a long file every time you wanted to look up 
a single item. You would still have to scan the screen 
visually to find the piece of information you were 
looking for, as if you were using paper files. A good 
program lets you pick out information selectively, so 
that the computer, and not you, does the searching. 


How to program a serial search 
The program that follows uses a simple but effective 
method to locate one item in a long list of DATA. It’s 
called a “serial search” because it searches the DATA in 
a series of stages. It takes the test string (T$) that you 
type in and compares it to each string in the program’s 
DATA statements in turn. It carries on until the test 
string matches one of the stored strings: 

SERIAL SEARCH PROGRAM 
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Lines 10 to 30 hold a list of names and telephone 
numbers. Lines 100 to 140 repeatedly READ a name 
(N$) and number (P$) from the DATA statements (note 
that the numbers are treated as strings). This carries on 
until a stored name is found to match the test string. 
Line 210 then PRINTs the phone number. 

If the computer cannot match the test string with any 
string in the DATA lines, line 170 announces that the 
name has not been found. If you now add the following 
line you can count the number of searches made before 
a successful match is found: 


215 PRINT AT 16,124;“ attempts” 


Now try RUNning the program to find the last 
telephone number on the list: 


SERIAL SEARCH DISPLAY 
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statement, 120 


You will find that the program takes 17 searches and a 
fraction of a second to find the last name in the list. 
That’s acceptable in a short program like this with just 
a few pieces of stored DATA. But for a serial search 
program with more than about 200 names or other 
items of DATA, the delay caused by looking at every 
single piece of DATA to find the correct one becomes 
quite noticeable. The program is simple but slow. 


Speeding up a DATA search 

Fortunately, another DATA searching method can 
speed things up considerably. It relies on the storage of 
DATA in strictly alphabetical or numerical order. The 
DATA stored in the program is repeatedly divided in 
two and the first item found there is READ and 
compared with the test string. This produces three 
possibilities. First, the two strings may be identical – a 
successful match at the first attempt. Second, the test 
string may come later in the alphabet or numerical 
order than the item found. Third, the test string may 














come before the item found. If the match is not 
successful, the half of the DATA in which the test string 
lies is further divided in two and searched in the same 
way until the strings are matched. 
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The DATA has been reorganized into two separate 
listings — one of names and a second of telephone 
numbers. In order to he able to locate one item in these 
DATA statements without having to READ through 
every item, the DATA must be numbered or tagged in 








Here is a program which carries out this “bisection 











some way. Line 40 does this by creating two numbered 
lists of DATA, or arrays. Lines 50 and 60 READ the 
relevant pieces of DATA into the two arrays. Line 130 
sets the conditions for the first search. The first item in 
the range to be halved, f, is one and the last item, 1, is 
18. If a match is not made at line 140, lines 150 and 160 
set the new values of f and 1 for the next search. 

If you RUN the program in the form shown here, it 
will answer “Name not found" to every test string. 
That's because line 40 tells the computer that every 
name string (N$) is 9 characters long and every number 
string (P$) is 11 characters long. A name like *Wendy" 
is therefore stored as Wendy ” which, as far as the 
computer is concerned, is not equal to the test string. To 
deal with this add: 

111 LET T=LEN T$ 
112 IF T<>9 THEN LET T$=T$+“ ":GOTO 111 
205 PRINT AT 16,12;t; attempts" 
This keeps adding spaces to the test string until it is 9 
characters long. Now the program КОМ and PRINTS 
the number of attempts to find a match: 

BISECTION SEARCH DISPLAY 


# STOP statement, 





The last item in line 10 is not a misprint. Because of the 
way the program divides the DATA into halves, the last 
name (WENDY in this case) would actually never be 
located. The maximum value of x is one less than the 
number of DATA items. To get around this, the dummy 
item ABCDE is added, so that all of the DATA can be 
searched successfully. 

Using this method, the last name can be found after 
only 5 attempts. To save time, the phone number, P$, 
is only READ when a successful match for the name is 
found. This time saving makes the bisection technique 
much more suitable if you want to search long lists of 
DATA. You could also use programs like those on pages 
24-25 to order your DATA before you use it in the 
bisection search program. By combining the programs 
you would have an accessible DATA bank. 




















PIE CHARTS 


Computer graphics are invaluable for displaying 
information in a way that can be understood ata glance, 
and one of the most easily understood displays that 
computers can produce is a pie chart. Pie charts are 
particularly useful for showing the relationship 
between a quantity and the amount of which it is a part. 


Drawing a fixed pie chart 
To produce a pie chart, the first job is to draw a circle, 
then you can start to put in the edges that mark off the 
"slices". Each edge is a radius of the circle. Once the 
first radius is DRAWn, all the other radii can be 
DRAWnR relative to the first one. It's like cutting a pie; 
it doesn't matter where the first cut is made, but after 
that, the size of each slice is determined by the angle the 

slice makes with the previous one. 
In the following program, one right-angled slice is 

DRAWnR in a circle: 
SINGLE SLICE CHART | 


BORDER 1 PAPER 4 
CIRCLE 126,655,850 
PLOT 126 4 DRAW 
PLOT 126 DRAW 











The program constructs the circle at the centre of the 
screen (128,88). Line 30 DRAWS the first radius from 
the centre to the right. Line 40 then DRAWS the second 
radius straight up to form the slice. 


Adding more slices 
You could go on to DRAW a second quarter-circle slice 
by adding the line: 


50 PLOT 128,88:DRAW 


and from there you could go on adding lines to DRAW 
further radii and build up a pie chart with a number of 
slices. But this sort of program isn't really very useful 
because you have to work out the positions of all the 
edges of the slices beforehand. 

However, the principle behind the first program can 
be used to write another program which will work out 
the positions of all the radii for you: 


VARIABLE CHART 


80,0 








ок, 0:1 

















Lines 20 to 90 set up the title and INPUT frame. Line 
10 tells the computer that the program will use a one- 
dimensional numeric array called s which will have 
three items in it. Each of these items will be the size of 
one of three slices that the loop at lines 60 to 90 asks you 
to type in. 

First, though, you must type in the total pie size in 
response to lines 40 and 50. Lines 100 to 170 DRAW the 
circle and radii in positions calculated using the slice 
sizes you typed in. The variable s, which was set to zero 
in line 10, fixes the position of each slice relative to the 
first radius. When n=1 for example, s=s+s(1). When 
n=2, then s=s+s(2). Finally, when n=3, s= 
s+s(3). For each value of s, a line is DRAWn from the 
circle’s centre to the point calculated using COS and 
SIN in line 160. 

You might wonder how this can DRAW lines which 
end to the left of, or below, the centre. When COS is 
used with angles between PI/2 and 3*PI/2 radians (90 
and 270 degrees), the number it produces is negative. 
So if COS(s*2*PI/t) is equal to —1, the radius is 
ОКА\ to an x co-ordinate of 128+(—80), or 48. 


Labelling the slices 
The previous program works well enough, but there's 
nothing to identify which slice is which — you need a 
good memory to know which slice represents which of 
the quantities you keyed in. So, next you can add a 
routine to label the slices: 

LABELLING ROUTINE 
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Line 121 sets up two arrays, x and y, which are used to 
store the co-ordinates of the ends of the radii DRAWn 
on the circle. There are four pairs, not three — those for 
the first fixed radius plus three for the slices whose sizes 
you have typed in. The co-ordinates of the end of the 
first radius are known (50,0), and these are set in 
line 122. 

For each value of n, the co-ordinates of the end of that 
radius are picked out of the arrays by x(n+1),y(n+1). 














The program uses these co-ordinates to PRINT a label 
on the screen. The position for the label is given by two 
co-ordinates x and y. These co-ordinates are half the 
distance between x(n) and x(n+1) respectively. The 
two graphics co-ordinates are then translated into text 
row and column numbers by lines 200 and 220. 

The two co-ordinates x and y are each divided by 8 
because there are 8 graphics pixels to each character 
position. But there is a disadvantage to calculating the 
label position this way. Since the label is to be PRIN Ted 
between the ends of the two radii, it will not work 
properly if the slice is more than half of the circle. 
However, for values less than this, the program works 
correctly and labels the pie chart for you: 


— LABELLED CHART 





For each label, line 240 PRINTS the same number 
against а corresponding coloured background and 
PRINTS the size of the slice beside it to give you a 
display of the figures keyed in. 

Try keying in the following answers in response to the 
question frame: 


500 — total income 
160 — bills 

100 — insurance 
180 — travel 


If you try these figures, you will end up with a chart that 
has a black unlabelled slice. This represents the amount 
of income that you have left over after the payments you 
have keyed in. 

You can adapt this program to show more than three 
slices by changing the number of INPUTS and the 
dimensions of the arrays. It is possible to make the 
Spectrum DRAW sections of a circle that are filled in 
with colour. However, if you use routines that DRAW 
with INK to fill in sections on the pie chart, you will 
find that you have difficulty getting smooth edges to the 
sections. This is because the Spectrum's INK works at 
text rather than graphics resolution. 
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DRAWING GRAPHS 





Because they are so good for games, computer graphics 
are often only partially exploited for more serious uses. 
But as you saw on the previous two pages, you can use 
your Spectrum to produce high-resolution graphics to 
show any information that you can put into number 
form. Pie charts are useful for showing how something 
is split up. Graphs, on the other hand, show how two 
sets of items are related. Here is a simple graph display: 
FIXED GRAPH Sis 








You don’t need to be a mathematician to get some 
useful information from this graph. As time goes by 
(along the horizontal axis), the value measured by the 
vertical axis is steadily increasing. 


How to set up a graph 

The program that produces the graph above has to 
DRAW the horizontal and vertical axes, label them, 
PLOT the points and finally DRAW a line: 

В — FIXED GRAPH PROGRAM 
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The sets of information are contained in the DATA in 
line 30. Line 40 DRAWS the two axes of the graph. The 
two loops that follow, between lines 50 and 80 and 
between lines 100 and 130, PRINT the labels along 
each axis. The first loop takes each letter in turn out of 
the DATA in line 20 and then PRINTs it along the 
horizontal axis. The position along the axis is 
determined by c in line 70. This increases in STEPs of 
4 (line 50) so that there is a gap between each of the 
labels. Line 110 PRINTs numbers up the vertical axis. 
This time, because the labels are a sequence of 
numbers, there is no need for them to be stored in a 
DATA line. Instead, they are produced by the STEP in 
line 100. 


Programming graphs to order 

The main disadvantage of the previous program is that 
it will only ever produce the same graph. You can 
change the information in the DATA lines, but this is a 
laborious way of altering the display. Ideally, you want 
a program that will allow you to type any co-ordinates 
you wish while the program is RUNning. Also, you 
don’t want to have to translate the graph’s co-ordinates 
into Spectrum screen co-ordinates before using them. 
So, the program must be able to do this conversion for 
you. 

The next program does all this. Although it produces 
axes that have set labels, you can key in any co-ordinates 
you like, as long as they fall within the graph’s limits: 

VARIABLE СКАРН РКОСВАМ  — 
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Line 20 DRAWs the axes as before. Lines 30 to 50 
PRINT the x axis labels. Here the program produces 
labels that could be time in hours. The program again 
uses FOR ... NEXT loops to determine not only what 
the labels are to be, but also where they are to go. As the 
column numbers of the horizontal label positions go 











from 4 to 28 and the values go from 0 to 24, the program 
uses the column number to produce the label in line 40. 

Lines 60 to 100 PRINT the labels up the vertical axis. 
Here they are chosen so that they can represent a range 
of temperatures in Centigrade. 

Line 130 invites you to enter a pair of co-ordinates. 
Туре in a time, press ENTER and type in a temperature 
followed by ENTER again. The computer BEEPs and 
line 150 PRINTS an asterisk at the screen position: 
VARIABLE GRAPH DISPLAY 





How to alter the display 

The graph display is quite coarse, because asterisks can 
only be PRIN Ted in the 384 character positions within 
the graph's area of 24 columns by 16 rows. For a more 
detailed graph, you could replace line 150 by: 


150 PLOT 32+192*h/24,24+ 1281/32 


This will produce a display with points instead of 
asterisks, each positioned on a graphics grid that allows 
higher resolution: 
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Altering the program so that it produces connected 
lines, rather than isolated points, is a little more 
difficult. What you need to do is tell the computer to 
PLOT a point, DRAW back from there to the previous 
point and then PLOT the second point again so that it 
in turn can be DRAWn back to. A program like this is 
ideal for writing with functions. Without them, the 
program lines would have to include repetition of a pair 
of quite cumbersome calculations for establishing co- 
ordinates. Here are the line changes and additions that 
are needed to make the program produce the line graph, 
together with a display: 
LINE GRAPH CHANGES 
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Two functions are defined by lines 180 and 190. They 
convert horizontal and vertical graph co-ordinates into 
Spectrum screen co-ordinates so that the program can 
PLOT and DRAW with them. Line 110 sets the first 
point (a,b) at the bottom left corner of the graph. Then 
every time you INPUT a pair of co-ordinates, the 
program converts them, PLOTS a point at x,y, DRAWs 
back to a,b, PLOTS x,y again and lastly, at line 160, 
makes a,b equal to x,y. 
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Graphic information can be presented in a number of 
different ways. Graphs, as you saw on the previous two 
pages, are good for showing trends, while bar charts are 
particularly useful for showing differences in levels. 

Bar charts are so named because the information in 
them is displayed not as single points, but as columns 
whose height corresponds to the size or level of the item 
shown. You will frequently see bar charts used on 
television to show changes in currency exchange values, 
numbers of votes in elections and so on. 


Writing a bar chart program 

Because a bar chart is essentially a graph, you can use 
much the same techniques as used in a conventional 
graph program to produce one. The main difference is 
that instead of PLOTting a single point when fed with 
co-ordinates, the program must construct a column. 
With the Spectrum, these are most easily constructed 
from a series of square graphics characters (using the 
graphics cursor plus shifted key 8). INK can then be 
used to. add colour to the chart. The next program 
incorporates this technique: 


В SIMPLE BAR CHART PROGRAM | 





PAPER o ІМК 7 С 


10 BORDER ө 
> 
RO PLOT 


224,24 DRAW -192,0 D 
STEP 2 
(c-2) 72 


4 TO 26 
PRINT RT 19,c; 
NEXT c 
LET nsóo 
FOR г=18 TO 2 
PRINT ЯТ г.,г; 
o LET nen+s 


-60) 72 STE 


PRINT INK ‚Рзм +2; EE" 


NEXT r 


3: ат 
NEXT 


The axes are DRAWn by line 20 in the same positions as 
those for the graphs on the previous pages. The 
FOR ... NEXT loop at lines 30 to 50 labels the x axis 
with the numbers 1 to 12, which could represent the 
months of the year. If the columns that the labels are to 
be PRINTed under go from 4 to 26 (STEP 2) then the 
month number is given by: 


month = (column —2)/2 

Try it — column 4, at the beginning of the axis, is 
equivalent to month 1. Column 26, at the end of the 
axis, is equivalent to month 12. There are 12 STEPs 
altogether. Here is the program in action: 
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Combining charts 

The bar charts so far have shown just one list of items. 
But it is possible to reorganize the first program so that 
it shows more than one set of information. You may for 
instance want to show both maximum and minimum 
figures like temperatures on the same chart. You don't 
have to rewrite the first program from scratch. A few 
additions will do the job: 


105 FOR п=1 TO2 

150 IF п=1 THEN PRINT INK 3; AT r,2*m+2; 
“иа” 

155 IF n=2 THEN PRINT INK 6; АТ r,2*m+2; 


“ша” 

170 МЕХТп 

This RUNS as before until you have finished keying in 
the first set of data. It then sets n to 2 and PRINTs 

















columns of yellow squares instead of magenta ones. The 
second set of data must be composed of figures smaller 
than the first set, otherwise the magenta chart will be 
overwritten by the yellow squares: 





MAXIMUM/MINIMUM CHART | 


As soon as you start EN TERing the second set of items, 
you'll notice that the x axis and part of the y axis of the 
chart disappear. You can get around this very easily by 
reDRAWing the axes each time a column is DRAWn: 


156 INK 7:PLOT 224,24:DRAW —192,0:DRAW 
0,128 


You will need to PRINT the columns as PAPER. This 
slows down the program considerably, so you may 
prefer to reDRAW the axes only once at the end, 
ENTERing the above line as line number 180. 





Splitting bars by changing INK 

One of the problems with the previous displays is that 
you cannot distinguish each bar on the charts, making 
it difficult to connect the bars with the scale on the x 
axis. You can get around this by using two different 
INK colours again, but this time alternating them as the 
bars for one set of INPUTS are PRINTed. It is then 
quite easy to see which bar relates to which figure on the 
X axis. 

The following program is an adaptation of the first 
one. If you take out the lines used for the double 
display, you can then edit the first program to produce 
the following one. Instead of having the INK colour 
fixed, itis now controlled by a variable a. A loop is used 
in conjunction with IF ... THEN to set the INK 
colour to either blue or red. When a is 1, the INK colour 
for that bar is blue, then for the next INPUT, when a 
becomes 2, the INK colour changes to red. You can use 
this type of colour-changing loop with as many of the 
INK colours as you like. If you want to increase the 
number of bars that can be made to appear on a chart, 
you can reduce the width of each bar by using a single 
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graphics square only. The program would also have to 
be altered to change the PRINTing positions. Here is 
the two-colour chart program and some sample displays 
that it can produce: 


rWO-COLOUR CHART PROGRAM 








10 BORDER #9: PAPER o INK 7 
> 
20 PLOT 224,24 DRAW -192,0 
RAW 9,128 
3 FOR с-а TO 26 STEP 
PRINT AT 19,с; (с-2) 72 
NEXT c 
СЕТ n=60 
FOR £218 ТО 2 STEP 一 
PRINT AT г,2; п 
LET п=п +8 


18-01-60) 72 STE 
INK а; AT r,esm«2; "NE" 


+1 нЕХТ а 
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GRAPHICS WITH GRAVITY 


On pages 18-19 you saw how SIN and COS could be 
used to make “natural” graphics, shapes that are 
sometimes seen in the natural world. To make these 
shapes you can just experiment with the graphics 
commands and see what happens. But if you want the 
computer to simulate something moving in a realistic 
way, an understanding of how it moves in real life will 
help you a great deal when you are trying to simulate 
that object’s movements on the computer screen. 

Let’s take a simple simulation using a bouncing ball 
and go through the steps necessary to build up different 
types of program. On pages 8-9 you saw how 
IF ... THEN could be used to “bounce” a ball in 
straight lines moving at constant speed. However a ball 
doesn’t move in straight lines. On the screen below is a 
short program to demonstrate how you could begin 
simulating a more realistic fall (the display beneath it 
includes after-images normally deleted): 

SIMPLE FALL PROGRAM 





BORDER 1. PRPER S INK 2. c 
ras .E 5... LET vei 
PAUSE 100 ' ' 


Go TO 








Falling objects are influenced by several forces — 
gravity, air resistance, surface friction and something 
called the “coefficient of restitution", which make them 
move in a complex way. However, you don't have to be 
a physicist to write a more realistic “bouncing” 
program. If you drop a ball, it falls to the ground and 
bounces up again, and that's all you need to know to 
simulate bouncing on the screen. 

In the previous program listing, line 30 PRINTS the 
*ball" near the top of the screen. After a 2-second 
PAUSE, the “ball” starts to move downwards. Line 50 
erases it. Next, the row number is increased by 1 and 
last, the “ball” is PRINTed again. 


Movement in two directions 
If you RUN this program, you will find that although 
the *ball" is indeed falling to the bottom of the screen, 
its movement doesn't look very realistic. The program 
also ends with an error message when the “ball” falls out 
of the bottom of the screen. The next program improves 
the display considerably by making the “ball” move 
sideways as well: 

SIDEWAYS FALL PROGRAM 








BORDER 1: PAPER 5. INK 2: C 
LET г=5: LET ¢=16: LET h=1 


vel 
PRINT AT r,c,"HB" 
PAUSE 100 

PRINT AT г.с". " 

LET rerev LET Cath 
PRINT AT r,c; W^ 
PAUSE 5 

GO TO зо 


осл0йвоти 
5599950646 


The variable h represents the change in horizontal 
position and v the change in vertical position. On each 
loop, v is added to the row number and h to the column 


number. Now it’s easy to modify the motion in any 
direction. For instance, you can make the “ball” 
bounce by adding: 


65 IF с-0 OR с-31 THEN LET h--h: BEEP 
0.05,20 
66 IF r=0 OR r=21 THEN LET v--v:BEEP 
0.05,20 


If you take out the lines which erase the “ball” as it 
moves, you will see a display like this. Note that the 














BEEP is only sounded when the “ball” encounters the 
edge of the screen: 
1 га SIDEWAYS FALL DISPLAY 








Simulating gravity 

Although the “ball” now bounces around the screen, it 
does not yet look completely realistic. The reason for 
this is that the “ball” on the screen does not mimic the 
effects of an object falling under gravity. 

You can add a “force” like gravity that acts in any 
direction, or that even changes direction during the 
program’s RUN. Gravity acts downwards, so, as the 
* ball" moves from top to bottom of the screen it should 
accelerate. When it bounces up from the bottom, it 
should begin to slow down until it falls back down to the 
bottom again. The next program imitates this effect. 
Type in the following listing: 


f 


| BOUNCING BALL PROGRAM 








BORDER 
DATA 48 


FOR пее 
READ 
POKE U 
NEXT n 
LET rss 
PRINT 1 
PAUSE 1 
I 


се 
REM PRINT 





In this program, the ball is a user-defined character. 
The gravity factor is added at line 110. The addition of 
0.2 to v means that the change in r- the vertical position | 
- is no longer constant. It increases on each loop, | 
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speeding the ball up. When the ball hits the bottom of 
the screen its direction is reversed (line 140) and 
therefore v becomes a negative number, repeatedly 
decreasing the row number. Moreover, the additive 
gravity factor at line 110 makes v less and less negative, 
slowing down the upward progress of the ball until its 
vertical motion ceases, v becomes positive again and the 
ball begins to move downwards once again. 

This display shows how the ball moves with this 
program: 





BOUNCING BALL DISPLAY 





The ball bounces around as before, but as it does so, it 
doesn’t reach the same height on each bounce. Its 
height is gradually decreasing, although its horizontal 
movement remains the same. The result of this is a 
rough example of a curve known as a “parabola”. 
Eventually the ball will bounce along the bottom line of 
the screen, just as a real one would. 

In just the same way as the vertical movement can be 
modified by a "force", you can alter the horizontal 
movement as well. This gives the impression of an 
object that is not only falling under gravity, but which 
is also being blown along by a strong wind. 

The curve that the ball makes during this program is 
not very smooth. This is because the ball is a text 
character, and its movement is limited to the 32x22 
character positions on the screen. If you want to 
produce smoother bouncing, you can experiment with 
the PLOT command instead. This will produce a single 
point at a graphics co-ordinate, allowing much 
smoother curving over the 256х 176 graphics grid. To 
do this, however, you would have to modify the 
program so that the character positions in all the lines 
were converted to graphics co-ordinates. If you refer to 
the grid on page 59, you should find that this is not too 
difficult. Because a single point is not very easy to 
follow, it is simplest to leave all the points PLOTted on 
the screen to make up a series of gravity curves, tracing 
the path of the point as it falls to the ground. 
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The next six pages will take you through writing a 
games program, showing you how to put all the phases 
together to build up a complete listing. Writing a games 
program requires some careful planning before you 
actually start writing lines. To begin with, you need to 
decide what sort of game you want. Many games 
combine your acquired skill with an element of chance 
(the roll of dice, the turn of a card, and so on), and many 
have a number of different phases of play, each of which 
confronts you with a different set of problems. 

To plan a game, it is best to start by drawing a rough 
sketch of the screen display, marking the colours and 
the positions of any fixed characters or patterns. You'll 
want to refer back to this as you write your program. 

Next, you can draw up a flowchart showing the 
program steps and the order in which they will appear 
in the program. It isn't necessary to draw a detailed 
chart — a list of the steps connected with arrows to show 
their order is sufficient. A complete games program will 
be more complicated than anything you've written so 
far, so it is worth designing the program before you key 
it in. It's easier to rub out a pencil arrow or a couple of 
lines on your plan than it is to start rearranging lines on 
the screen if, when you try to RUN it, you find that the 
program doesn't work. 





Keying in phase 1 

With the game on this page, the planning stage has been 
completed, and you can now key in the first part of the 
two-phase program. The listing that follows is for a 
practical game – one that anyone should be able to play 
without any prior knowledge of*the program or the 
computer. Below is the first screen of the program. This 
phase of the game involves shooting at a moving 
spacecraft: 


PHASE 1 SCREEN 1 
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The program gives you a laser base which you can then 
move left or right. You can fire, but only straight up the 
screen. À number of spacecraft approach you one by 
one, and you must destroy them to carry on. 

'The DATA for the user-defined spacecraft and laser 
base are READ in by the loop at lines 50 to 90. The time 
taken to complete the game will be used later to 
calculate the score, so a time function is defined at line 
100, using a technique mentioned on page 21. Some of 
the variables used in the program are initialized (set to 
their starting values) by line 110. 

'The program is impossible to decipher if you don't 
know what these variables represent. The following 
table outlines what each of them does. 


The first phase of the game uses a total of fo 
variables to control graphics and record strikes. 


Variable(s) Function 

rc Fix row and column co-ordinates of spacecraft 
lm. Fix row and column co-ordinates of laser base 
h Records successful laser strike 


f Records total number of laser strikes on target 


q Records number of times laser fired 
х,у ых Fix starting point of laser beam 


a Sets change in position of spacecraft (= if left 
to right, otherwise= = 1) 


COMME Co quales A a 
_ .  fetscolumn position of mine explosion 
Records time taken to complete game when 
subtracted from FN t( ) 


General variables 





Line 120 sets the random starting point for the 
spacecraft. Line 130 starts your laser base off in the 
middle of row 17. In line 140, n records the number of 
spacecraft attacks. When there have been five attacks, n 
will equal 6. When it does, the program jumps to line 
400 and the scoring calculation. 

The second screen of the program contains a number 
of lines which make decisions and then direct the 
program to later subroutines. You will notice as you go 
through the listing that the line numbers sometimes 
jump by more than 10. This is because it is simpler to 
give subroutines line numbers that are easily 
remembered - multiples of one hundred are 
convenient. \ 

When you key іп the second screen’s lines, remember 
that D and Cin lines 170 and 180 represent user-defined 
characters. This means that you will need to switch to 
the graphics cursor so that they are not PRINTed as 
letters (after the program has been RUN they can then 
be LISTed in the form in which they appear in the 
game). The second screen looks like this: 














PHASE! SCREEN 2 


THEN LET mz 
THEN LET Moms 


e THEN LET m=O 
fv 1 


THEN GO 


After a random PAUSE (line 160), the laser base and 
spacecraft appear again. Lines 200 and 210 let you move 
your laser base to either side and line 220 stops it 
disappearing out of the side of the screen. If you press 
the M key, the program jumps to the “fire” routine at 
line 500. If that records a hit, the program jumps back 
to line 120 and begins a new attack. 

Lines 250 and 260 control the movement of the 
spacecraft. Lines 270 and 280 make the program jump 
to the mining routine — which is positioned by a variable 
listed in the table on the opposite page — at line 600 once 
in every 20 spacecraft moves. This is done by picking a 
random number from 1 to 20; just one of these numbers 
will trigger the mining routine. Line 290 continues the 
same attack by jumping back to line 170. 

Lines 400 and 410 calculate the score and end this 
part of the program. The score is based on the time 
taken to complete the program, the number of times the 
laser was fired and the number of direct hits. The score 
isn't actually used here, but it will appear again later as 
you develop the game. If you want to check that the 
scoring lines are working, RUN the program and then 
key in the direct command PRINT s, without a line 
number. Your score should then be displayed on the 
screen. 


The subroutine section 

Finally, here is the last part of the first program. It 
contains a pair of subroutines. Lines 500 to 550 DRAW 
and “unDRAW” the laser beam using DRAW and 
OVER 1. If m=c then the laser has hit its target. Lines 
600 to 690 explode a. mine on row 17. The mine's 
column position is random. If it lands on the laser base, 
the q value of your score will be affected. 

Once you have typed in the listing on the following 
screen and RUN this phase of the game, SAVE it on a 
tape so that it is ready to be combined with the next part 
of the program: 
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Here is the program in action. In the first display, the 
laser is firing at the spacecraft, while in the second, a 
mine has appeared: 





PHASE 1 DISPLAYS | 



































In the second phase of the program, the scene changes 
from the air to the sea as a ship tries to depth-charge a 
moving submarine. Again, the aim is to hit the enemy to 
produce the best score. The scoring instructions are still 
not used in this phase, but are ready to be brought into 
operation when the last phase of the game has been 
keyed in, linking up the first two parts. 

As before the program uses a number of variables to 
control movement and subroutines. These variables 
need some explanation if you are to follow what is 
happening (in your own games you could use REM 
lines to remind you). 








The second phase uses six variables to control the three objects 
animated by the program. 

















Variable(s) | Function й 
c After line 1090, this fixes the column 
mor с position of the ship : 
59 3 Fix row and column co-ordinates of 
submarine ; 2 
[ Records when depth-charge has been 
dropped 








Fix row and column co-ordinates of 
depth-charge 


u,e 












Setting the scene 

The first section of the program produces the coloured 

screen, and selects some random numbers: 
DISPLAY/ANIMATION SECTION 
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For the moment, ignore line 100 — you will find out why 
it is included on the next page. Lines 1050 to 1090 
PRINT a blue sky over the green sea, simply by laying 
down rows of blue INK squares on top of the green 
PAPER background. Line 1100 sets the column 
position for the ship and lines 1130 to 1160 control its 
movement across the screen. 














The aim of this game is to hit the submarine. The M key 
controls the release of the ship’s depth-charges. The 
ship is also manoeuverable. If you press the Z key the 
ship will move to the left, while pressing the X key will 
make it move to the right. All these functions are 
controlled by INKEY$ for a rapid response. The ship 
always starts off in the middle of the screen. The 
position of the enemy is less predictable. Lines 1110 
and 1120 set the random starting point of the 
submarine. It may appear at almost any depth in the 
water and at any point across the screen. 


Main program and subroutines 
The second part of the program contains some of the 
main program, together with a number of subroutines 
which the main program calls. The subroutines control 
movement on the screen and detect whether or not your 
depth-charges have hit the target: 

j SUBROUTINE SECTION 
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Line 1200 makes the program jump to the depth-charge 5 PHASE 2 DISPLAYS” 
routine at line 1300 if you have pressed М. The score, $, 
is also adjusted every time a depth-charge is dropped. 
The score is related to the time that has passed by using 
ЕМ t() in the last line of the program. Lines 1210 to 
1240 control the movement and appearance of the 
submarine. Line 1250 continues the program by 
returning it to line 1130 to check the keyboard for key- 
presses. 

Lines 1300 to 1360 make a depth-charge travel down 
the screen. The charge is composed of the graphics 
character on key 3. If the charge reaches the bottom of 
the screen, line 1330 returns f to its original value (zero) 
and RETURNS to the main program. However, if the 
position of the depth-charge coincides with any position 
occupied by the submarine (line 1350), then that attack 
is terminated and a new one started. You will notice 
when you RUN the program that only one depth- 
charge can be released at a time. If f has been set to 1 by 
line 1200, when a depth-charge is dropped, line 1190 
stops you from dropping another charge until f is once 
again equal to zero. This will be true either when the 
charge reaches the bottom of the screen (line 1330) or 
when it hits the submarine (line 1350). 

'The program uses keyboard graphics to make up all 
the objects in this display, and as you can see from the 
following screens, the results show the block outlines of 
these characters. However, it is easy to improve the 
game by using user-defined characters instead. To make 
a ship or submarine, just PRINT a row of characters 
together. The greater resolution that you can then 
achieve will considerably improve the display, although 
more programming lines will be needed. 

Here are some displays of the game in action. In the 
third screen, the path of a single depth-charge is shown 























by putting a REM command in line 1310, disabling the You might have noticed that there doesn't seem to be 
PRINT command which normally erases the charge any means of erasing the old unwanted images of the 
every time it moves down one position: ship and submarine before the new images are 

PHASE2 DISPLAY PRINTed. As both only move one character position to 


either side of their current position, they can be 
effectively and simply erased by including a blank 
square (a space) to either side of the graphics. 


The scoring routine 
The time is once again used to calculate the score at the 
end of the game. In the final version of this program, the 
time function will be defined in the first phase of the 
game, so a second definition is not necessary in this 
part. However, if you want to check that the program is 
working properly, you need to have the time function so 
that you can PRINT s. Line 100 is put in here so the 
scoring routine can be tested. The timing function will 
be taken out again when the final version of the game is 
written. 

When you have checked that the program КОМЗ, 
SAVE it on cassette ready to be combined with phase 1. 
ao 0 RIE == E 





























Now that you have keyed in and SAVEd the first two 
phases of the game, you are ready to add the game 
instructions and complete the part of the program 
which will produce the score. The first problem to 
overcome is that the two programs are SAVEd as two 
separate files on your cassette. To RUN as one program, 
they need to be combined. You cannot simply LOAD 
one program from cassette onto another which is 
already in the computer’s memory. If you do this, you 
will find that the program in memory will simply 
disappear, just as if you had pressed NEW. 

The Spectrum has a command to deal with this 
problem — MERGE. It adds together the contents of 
two files. ‘To see how MERGE is used, imagine that you 
have SAVEd both programs from pages 38—41 on tape, 
but that the “sub sinker” program is already in the 
computer's memory. If you then type: 


MERGE “” 


— putting the first filename inside the quotation 
marks — and then press ENTER and play the tape, the 
first program will be LOADed into the computer. This 
time the “sub sinker” program will not be erased, as 
happens with LOAD. However, MERGE only 
combines programs properly if their line numbers do 
not overlap. The extra line (100) added to the “sub 
sinker" program so that you could test the scoring 
routine will be over-written by line 100 of the first 
program. This is why the “sub sinker” is numbered 
from line 1010 onwards. If it had been numbered from 
line 10, it would have been over-written by the first 
phase of the game wherever there were lines of the same 
number. 

The two MERGEd phases are now a single program. 
As a safety precaution you could now SAVE the whole 
program on cassette. This is well worth the trouble if 
you are developing a long program, because accidental 
deletions can otherwise take a long time to put right. 


Adding the game instructions 
If you RUN the MERGEd program, you will find that 
although it is theoretically one program, it still behaves 
às two separate units. When you are writing games 
programs in phases like this, you will need to do a little 
tailoring to the final MERGEd program to make it 
RUN through properly. 

Linking the two phases is easily done. Change line 
410 to: 


410 GOTO 1000 


That’s not a mistake, even though the “sub sinker” 
program begins at line 1010. It's to allow you some 
space to add game instructions starting from line 1000. 





Now you can go right back to the beginning and start 
the program off with a title frame containing all the 
instructions the player will need. The keys that control 
the movement of objects on the screen need to be listed. 
You also need to tell the player how to start the game, 
bearing in mind that by the time the message appears, 
the program that contains the game will already be 
RUNning. Here are four lines that give the openine 
instructions for phase 1: 
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Lines 1 and 2 PRINT the game title, and explain its 
controls. Line 3 stops the computer from accepting 
your RUN and ENTER key-presses as the trigger to 
start the game. The next time you press a key, the 
condition for repeating line 4 is broken, and the first 
phase of the game begins: 

PHASE 1 INSTRUCTIONS 


Five alien spacecraft 
are Laying mines in your zone 


You must destroy the aliens 
222555 ЗАЛА ат + + 


LASER BASE CONTROLS 
z:teft xitright m.fire 


Press any key to start 


The instructions for the second phase of the game are 
inserted in a similar way: 

















PHASE 2 INSTRUCTION LINES 
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Press any key to start 


You can of course use any keys you want to specify 
movement as long as you change them throughout the 
program. Now neither phase of the game starts until the 
player is ready and presses a key to begin. 


Completing the scoring routine 

Finally, a scoring routine needs to be added to the end 
of the MERGEd program. The final score line of “sub 
sinker" is retained: 


1400 LET s-s--FNt()- T 


However, if you have played the two games 
independently and typed PRINT s afterwards, you will 
have noticed that the first phase of the game yields a 
result ranging from — 20 or so to several hundred, but 
the second phase produces results of several hundreds 
to several thousands. The results of the two games need 
to be of the same order of magnitude. That can be 
achieved by multiplying the running score total in line 
400 by 100. This makes the score compatible with that 
from phase 2: 














400 LET s=100*(FNt()—T)/5+q | 2—(10xf) 
'This line is a good test of your understanding of the 
variables from pages 38-41! To make the presentation 
of the score more interesting, you can add a few more 
lines to turn this purely numerical score into a ranking: 


SCORING ROUTINE 
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Lines 1410 to 1480 divide the scores up into bands, each 
of which is assigned to a rank. A series of IF ... THEN 
lines decides where your score comes in the ranking. 
You can change the cut-off scores for each band to make 
the games harder or easier. 

You now have a complete two-phase game with 
instructions, action and a scoring routine. Although the 
two phases used on these pages are relatively simple, the 
way that they are combined can be used to build up 
games of your own that are much more complex. You 
can use MERGE to put together a number of sub- 
programs, each written and tested independently. The 
only restriction on this is the size of the computer’s 
memory, but unless you are combining very long 
programs, this shouldn’t be a problem. 














On the Spectrum the command used to produce sound, 
BEEP, is quite straightforward. A line like: 


100 BEEP d,p 


will produce a sound that is d seconds long at a pitch p. 
But one of the problems of using BEEP in programs is 
that it stops everything else while it is being carried out. 
This means that if you want to produce long sounds in 
conjunction with movement on the screen, you cannot 
use a single BEEP command, or the program will 
"freeze" until the BEEP has finished. To link sound and 
animation as well as possible, BEEP needs to be used 
briefly but frequently, so that the sounds produced add 
up to give the effect you want. 


How to improve sound with animation 


You can hear BEEP working badly with animation if 


you RUN the following program: 
BASIC SOUND AND ANIMATION PROGRAM 
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18 THEN GO TO 150 
260 BEEP 0.2,25 
270 со TO 169 














'The flying saucer is made up from six user-defined 
characters arranged in two rows — a,b,c on top and d,e,f 
underneath, with one space either side. In addition, a 
row of spaces is PRIN Ted above and below the saucer, 


so that, whichever way it moves, the spaces 
surrounding it erase the previous image. Line 200 
produces a 0 or 1 at random. Line 210 turns that into 
either —1 or +1. This will be used to change the 
position of the saucer. Line 220 produces another 0 or 
1 at random. If it's a 0, the saucer's row is changed by 
the variable a. If the result of line 220 is 1, the saucer's 
column is changed by a. This moves the saucer around 
on the screen in an unpredictable way. Line 250 tests to 
see if the saucer has reached the edge of the screen and 
if so brings it back to the centre. The sound is dealt with 
in line 260 in a single BEEP statement lasting a fifth of 
a second. It can be improved by adding these lines: 
NEW LINES TO SPLIT SOUND 
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The first version is a very poor example of animation. 
Effective animation relies on changing from one 
character display to the next as quickly as possible, but 
in that program the single BEEP interrupts the 
movement for too long, so the saucer moves in a slow, 
halting way and the sound effect really doesn’t add 
much to it. 

By adding the lines listed on the previous screen you 
will split the BEEP up into a number of shorter sounds, 
thus improving the quality of sound in the program. 
Each BEEP now lasts for only five hundredths of a 
second. The total duration of all the BEEP statements 
(0.035 seconds) is less than a quarter of the length of the 
single BEEP used previously, so this program RUNs 
approximately four times as quickly as the first version. 
Moreover, because the sound effect is split up into a 
number of separate statements, this gives you a chance 
to sound them at different pitches to produce a much 
more interesting warbling effect. 

You could also write more BEEPs between the 
introductory lines (10 to 140) to announce the arrival of 
the saucer in advance of its appearance, but note that 
any BEEPs written into lines 50 to 130 will sound eight 
times because of the n loop connecting them. 


Linking BEEP to screen positions 

One very effective way of producing sound with 
animation is to link the BEEP pitch to a variable that 
controls a character’s position on the screen. You will 
have already encountered this with the “bouncing” 
program on pages 8-9. Linking BEEP like this is fairly 
easy, and it cuts out quite a lot of programming lines. 
All you have to ensure is that the variable controlling 
the BEEP comes within the right range, and is used to 
change the duration or pitch of the BEEPs in the right 
direction. You can experiment with these techniques on 
the next program. Type in the following listing and 
RUN the program: 
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This program PRINTS a star field and then moves а 
keyboard graphics rocket upwards through it. Lines 10 
to 60 PRINT the star field. Lines 70 to 130 PRINT and 
move the rocket. When you RUN the program, the 
following display should appear: 


LINKED BEEP DISPLAY 








Now you can add the sound effects to the above 
program. This time, their aim is to produce an unusual 
sound of changing pitch. What is needed is a BEEP 
statement containing a variable whose value changes 
every time the BEEP is carried out. The obvious thing 
to relate the pitch to is the changing row number. The 
problem is that the sound should increase in pitch as the 
rocket rises, but as it does so, the row number 
decreases. So if the pitch were simply made a multiple 
of or a fraction of the row number, it, too, would 
decrease as the rocket rose up through the star field. 
However, there is a way of overcoming this problem. 
Try typing in this line: 
125 ВЕЕР 0.05,80—(10*r)/2 
Now the smaller r is, the higher is the pitch number. If 
the range of pitch is too large, multiplying r by a smaller 
number will reduce it: 
125 ВЕЕР 0.05,80— (5xr)/2 
If the pitches are too high overall, reducing the starting 
value (80) will bring all the BEEPs down in pitch: 
125 ВЕЕР 0.05,60— (5xr)/2 


To make the sound more interesting, you can split it 
into two components: 


75 ВЕЕР 0.025,60— (5xr)/2 
125 BEEP 0.025,63 — (5жг)/2 


'The second sound is slightly higher in pitch than the 
first, giving a progression in pitch between the two. 
Using a number of even shorter BEEPs in these lines 
will make the sound effect even more complex. 

























































In many Spectrum games programs, areas of INK 
colour on the screen represent objects that you have to 
avoid. If you hit them, the programs respond with a 
penalty of some kind. But how do you go about 
programming the computer to decide if a character you 
are moving on the screen has hit something? You could 
use IF ... THEN to check co-ordinates, but there is a 
way that is much easier and quicker. 

The Spectrum BASIC command POINT lets the 
computer examine any point on the screen and test 
whether it is a PAPER or an INK colour. In the line: 
100 a=POINT (x,y) 

a will be equal to zero if x,y isa PAPER colour, or it will 
be equal to 1 if x,y is an INK colour. 

The next program produces INK squares at random, 
and then lets you test whether a particular pair of co- 
ordinates is covered by a PAPER or INK colour: 


PAPER/INK TESTER 





























Lines 20 to 60 PRINT dark blue squares in random 
positions on a cyan background. The bottom line of the 
screen is left blank for use later. Line 70 switches to 
black INK. Line 80 waits for you to type in the x and y 
co-ordinates of any point on the screen. 

Type in an x co-ordinate (0-255), press ENTER, and 
then type in the y co-ordinate (0-176) and press 
ENTER again. Line 90 will then test whether this point 
is PAPER or INK. Line 100 PLOTS a black point at x,y 
to mark it. Note that this program would not work if 
lines 90 and 100 were reversed, because x,y would 
always be an INK colour, coming immediately after 
PLOT х,у. 

The result of line 90 is PRIN Ted on row 21 by lines 
110 and 120. If x,y is a PAPER colour, the point 
EN TERed appears as a small black dot on the screen. If 
x,y is an INK colour, the whole character-sized square 
turns black because if you change the INK colour of a 
single point in any character position, the whole 
character position changes to the new INK colour. 


Using POINT with animation 

Now you know how POINT is used, you can try out a 
practical application of the command. You have 
probably come across a situation where you have several 
characters on the screen, but you don't want to go to the 
trouble of storing their positions and recalculating 
when any of the characters move in order to keep track 
of them during animation. 

The next program gets around that problem. It uses 
POINT to test for the position of obstacles scattered 
over the screen as a character bounces between the 
screen edges. There are only a few obstacles in this 
display, but you can easily increase the number by 
altering the range of the loop between lines 20 and 50: 
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The program uses POINT to locate INK characters оп 
a PAPER screen. Lines 20 to 50 PRINT dark blue 
mines (squares) on a yellow PAPER screen. Line 60 sets 
the start position for the minesweeper (a copyright 
symbol). If this start position coincides with any of the 
random blue squares, a new set of random squares is 
PRINTed. Lines 80 to 150 form a routine that you have 
encountered several times now. It makes the 
minesweeper bounce around the screen from side to 
side and top to bottom. Every time the minesweeper 
reaches one of the screen’s four edges, its direction is 
reversed and a BEEP sounded. The BEEP produced 
when the minesweeper reaches the sides of the screen is 
much higher in pitch than when it reaches the top or 
bottom edge. 

For each position the minesweeper symbol moves 
into, line 120 converts its row and column co-ordinates 
into the x,y graphics co-ordinates of the mid-point of 


the position. Line 130 then checks whether this is a . 


PAPER or INK colour. If it is a PAPER colour, the 
program jumps back to line 80, erases the minesweeper 








and rePRINTS it in a new position (calculated by line 
110). If it’s an INK colour, line 130 returns the value 1 
and the program jumps to the explosion subroutine at 
line 190. This repeatedly PRINTs two graphics 
characters in a range of different colours, accompanied 
by sound effects. After every explosion, the program 
jumps back to line 10 and starts again: 
SWEEPER DISPLAYS 





The number of mines is set to 5 so that the minesweeper 
has enough space to go back and forth across the screen 
several times before it hits anything. You can provoke 
an explosion more quickly by increasing this number in 
line 20. Masking the PAUSE in line 140 will also speed 
up the program. 

Using POINT in routines like this enables you to 
program the computer to make a complex decision with 
a simple series of commands. POINT is very useful in 
games where you are controlling an object that has to be 
steered around the screen and kept clear of walls or 
other obstacles. You can test your skill at computerized 
navigation by using POINT to direct the program into 
a crash or penalty subroutine when you steer into INK. 























PATTERNS WITH SYMMETR 


If you make the Spectrum produce a pattern at random, 
the display produced will be entirely unpredictable. 
Using a simple technique, it is possible to generate a 
random display in a way that produces a symmetrical 
result. An unpredictable display makes a random 
pattern all over the screen, a technique that is useful for 
producing a background “galaxy” effect for a star wars 


game. But with a symmetrical display, the first part of 


the program produces a random pattern in one quarter 
of the screen, while subsequent parts of the program 
repeat this random pattern in each of the other three 
corners of the screen. The effect is like seeing part of the 
display reflected in a mirror. 

To see how you do this, first you need a program that 
produces a random display. On the Spectrum this is 
very easy: 

RANDOM DISPLAY PROGRAM _ 


BORDER 3 PAPER 1: INK 7: C 


FOR n=1 TO 300 
амо +3 
URIND +2 
с: та" 


NEXT n 





This short program repeatedly produces row and 
column co-ordinates for a random location on the 








W^ VP 
screen. Although the column furthest to the right is 
numbered 31, the expression in line 30 that produces 
the column number includes 32, because INT rounds 
numbers down to the nearest integer, so the highest 
value that INT(RND*32) can have is 31. The graphics 
symbol on key 8 is used to produce the display. The 
program positions 300 squares at random. There are a 
total of 704 character positions, so, at most, about half 
the screen is covered. There's nothing to prevent lines 
30 and 40 producing the same pair of co-ordinates on 
several occasions, so that often the INK squares will 
take up a smaller area than this. 


Reflecting a random pattern 
Now you can use the graphics symbol, but in a slightly 
different way, to turn this entirely random pattern into 
a random pattern with symmetry: 


SYMMETRICAL DISPLAY PROGRAM 








BORDER 1: 


FOR п=1 TO 75 
КЕТ сЕ НТ 
.E CS INT 
PRINT AT 

LH “SAT в81-г,с;" 


GO NEXT n 


This program divides the screen into four equal 
quarters. All of the co-ordinates that lines 30 and 40 
produce lie in the top left-hand quarter. They are 
copied onto corresponding locations in the other three 
quarters. Because each pair of co-ordinates produced 
gives rise to four symbols PRINTed on the screen, the 
program only needs to carry outa quarter the number of 
loops as the previous program. The maximum value of 
n in line 20 is therefore reduced to 75, but this produces 
300 images as before. The first of the next pair of 
screens shows a typical RUN of the program. The 
second screen shows the result of adapting the program 
by changing line 10 to: 

10 BORDER 1:PAPER 0:INK 6:CLS 


and then using a smaller graphics character (this time 
on the 3 key). The program will produce a different 
display every time it is RUN: 














SYMMETRICAL DISPLAYS Each is as far up from the bottom of the screen as the 
seed point is down from the top, so their co-ordinates 
are the 21 —r,c and 21—r, 31—c in line 50. 





Programming a crossword grid 
Most crosswords are constructed from a symmetrical 
grid, and by reflecting the black squares in one corner of 
the crossword grid, you can program the computer to 
PRINT the complete pattern. Again, "seed" squares 
are positioned at random: 

CROSSWORD PROGRAM _ 








© OK, 60:1 








The program works out the positions of the mirror 
images of each original “seed” symbol by performing 
some simple arithmetic on the co-ordinates r,c. The 
first mirror image is on the same row as the seed, but on 
the opposite side of the screen. Its co-ordinates are 
therefore r,31—c. Each point is reflected by two others 
in the bottom half of the screen. 


___USING SYMMETRICAL CO-ORDINATES | 











| Seed point | 

| Lines 20 to 50 DRAW the grid. The grid is 12 squares 
E Е across and 12 squares down. This line spacing is chosen 
rc r3l-c so that each blank square that lies within the grid is the 


same height and width as a keyboard character (8 
| graphics pixels across and 8 down). The RND 
| statements in lines 70 and 80 are chosen so that the 
ЕЗ random co-ordinates produced by them always lie 

within:the crossword grid. Line 90 then PRINTS the 
seed point and its three mirror images as in the previous 
program. Wherever a graphic square is PRINTed, it 
fills a blank square in the grid. 


21-г,31-с 























The Spectrum is much more helpful than many 
microcomputers in tracing errors or “bugs” in 
programs. Some computers will let you type in almost 
anything; you only discover that your program does not 
make sense when you RUN it and get a whole 
succession of error reports. The Spectrum, on the other 
hand, checks each line you type in for errors before you 
can use it in a program. 

Although you cannot spell a keyword wrongly, 
because the Spectrum’s entry system works on single 
keys, it is easy to use punctuation incorrectly. If you 
miss out a semi-colon after an AT, or separate two 
commands with something other than a colon, for 
example, a flashing question mark appears on the line 
when you press the ENTER key. Its position indicates 
where the error is. All you have to do is move the cursor 
back down the line and correct the error. If the cause of 
the error isn’t immediately apparent, check that you 
have used the commands in question correctly. 

This system of entry-checking does not mean that 
you can’t make a mistake when programming the 
Spectrum. You can easily write a program which the 
Spectrum will accept, but which is still riddled with 
errors. Here is a program that is full of errors. If you key 
itin (the computer will accept all the lines) you can then 
see how to go about a thorough "debug". 

'The program is the *hangman" game from page 27, 
but it has been written and ENTERed hurriedly, so 
that it will not work. Don't cheat by looking back at the 
correct program! Go through the listing and see if any 
bugs are obvious to you. See how many you can find, 
and try and work out how you would correct them. 
Then check your’ results against the bugs that are 
explained on these pages. 

Key in the program as it is and then try to use it: 

BUGGED “HANGMAN” PROGRAM 
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When you try (о RUN the program you will find that 
the title frame comes up and you are invited to ENTER 
the test string. But when your press ENTER, the error 
report *1 NEXT without FOR, 100:2" appears. This 
means that the program has stopped at the second 
statement in line 100. LIST the program. You will see 
that a loop containing n begins at line 80, but the NEXT 
statement in line 100 says NEXT 1. To make the loop 
work properly, change this to NEXT n. Now try the 
program. again: 

"CRASHED" PROGRAM DISPLAY 








HANGMAN 


Ask a friend to type а 


or phrase for you то guess 


DON'T LOOK AT THÉ SCREEN 


Press ENTER whem you're finished 


This time the title frame and test string entry work 
properly, but the title frame stays on when the next 
phase of the game starts. That's easily dealt with. Add 
:CLS to line 70. You may also have got a “В Integer out 
of range" error report on screen. The characters 
representing the test string are also PRIN ed in the 
wrong position. They may have run out of the side of 
the screen as shown above. 





^ 


= 





iia ee | a ae 


The expression in line 100 should PRINT all the 
characters in the middle of the screen. It should read: 


(32— 1)/2+п 


but in the program, the division by 2 has been missed 
out altogether. 

The display instructions tell you that a hyphen 
represents a letter, but a row of the letter j is PRINTed 
instead. Moreover, if you've ENTERed a test string 
containing any spaces, you'll have found that the black 
square graphics symbol has not appeared. 

'The j-line has appeared because the programmer 
forgot to press the shift key to get a hyphen. Correct 
that, then look at line 90 again. This line checks for a 
space in the test string and if necessary PRINTS a black 
square, but this is masked by whatever line 100 
PRINTS. If you add: NEXT n to the end of line 90, then 
when a black square is PRINTed, the program will 
move on to the next value of n and the next character in 
the test string. 


Further test RUNs 

Now, when you RUN the program, as soon as you 
ENTER your first guess at a letter, you will get a “2 
Variable not found, 160:1" error report. The only 
variable in line 160 is s, which represents the score. It 
seems straightforward — it PRINTS the score. This line 
is, in fact, correct. The error report is PRIN Ted 
because the computer doesn't have an initial value for s, 
which it can PRINT. So, add :LET s=0 to the end of 
line 70. When you have keyed in these corrections, 
RUN the program again: 

~ СКАЅНЕР” PROGRAM DISPLAY 











нансман 


~:tetter A space 


scoresx0 


есте; 
а the Whole thing 


Now, when you type in a correct guess, it will probably 
appear to the right of the screen. Alternatively, if it 
represents a letter that appears towards the end of the 
test string, you may even get a “В Integer out of range, 
180:2" error report, because the computer has tried to 
PRINT the character off the screen altogether. Once 














again, the division by 2 has been omitted from the 
column expression. It should read as follows: 


(32-1)/2+п 


The game now seems to work properly, but if you look 
at the score, you will see that it’s not increasing. The 
score should go up by 1 after each guess and this has not 
been written into the program, so add LET s—s- 1; to 
the beginning of line 160. 

Although single-letter guesses will work properly 
now, the computer refuses to respond correctly when 
you press 1 to guess the whole string. Line 150 should 
make the program jump to the whole word guess 
routine, but it actually leads to line 190, which is simply 
NEXT n. This is a very common fault after you have 
renumbered any of the program's lines, and perhaps 
forgotten to renumber the GOTOs and GOSUBs. 
Change the GOTO statement in line 150 to GOTO 210. 
The following display should appear: 

~~ OVERPRINTED DISPLAY 


HANGMAN 


B space 


=: letter 


CORRECT ~ 


whole thing 


Try typing in a correct guess for the whole string. The 
“CORRECT” frame is PRINTed over the previous 
game frame. That's easily put right — change line 220 to: 


220 ТЕ th=a$ THEN CLS:PRINT АТ 11,12; 
“CORRECT”; АТ 13,123“score=”3s+ 1 


Finally, the program refuses to stop. When you’ve 
made a correct guess, the program immediately 
restarts. So, add :STOP to the end of line 220. The 
program should now RUN properly. 

If you are developing a program, constant checking 
should prevent all but a few bugs from slipping into the 
final listing. When you’re testing a program that you’ve 
written, put it through all the situations it will meet in 
use. If it’s supposed to have safeguards to stop it 
“crashing” in some circumstances, test them too. 
Testing the end of a growing program with GOTO will 
ensure that each routine actually works before you 
move on to the next. 


























One of the features of BASIC is that, if you want to, you 
can write programs without much prior planning. With 
many other computer languages, a much more 
organized approach is needed. Although BASIC is easy 
to use, it doesn’t encourage the best programming. 

One area where good and bad programming show up 
is in RUNning speed. While it’s not of great importance 
that a short program RUNS quickly, RUNning speed 
does become more significant as your programs become 
longer and more complex. Ideally, you will want them 
to RUN as quickly as possible. On these two pages you 
can see how a poorly written program compares with a 
version that has been streamlined. 


A “slow” program 
The following program is of the type used on page 23 to 
show how arrays can produce spreadsheets on the 
screen. Here is the program listing: 





“SLOW” TAX TABLE PROGRAM 





ccs 
FOR меге TO 164 STEP 16 
PLOT 28.4 CRAY 200,0 
NEXT y 
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items and — given the current tax rate — calculates the 
total cost of the items. The information is presented as 
a table. To test the program's RUNning speed, lines 20 
and 30 start timing the program as soon as it starts and 
line 300 PRINTS its total RUNning time on the bottom 
line of the screen: 

“SLOW” TAX TABLE DISPLAY 
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The unit prices are stored in the DATA statement at line 
50, and the numbers of each item in line 60. Both arrays 
are dimensioned by line 40. The loop at lines 70 to 100 
READS the unit price DATA into the one-dimensional, 
eight-element array p. A similar loop at lines 110 to 140 
READS the numbers DATA into the n array. Lines 150 
to 220 clear the screen, DRAW the grid of intersecting 
lines and PRINT the column headings - “No” for 
number and “SUB” for subtotal. Lines 230 to 290 
calculate and PRINT the figures to fill the grid. 

On looking through the listing, you might have 
noticed that two loops use the same variable (a) over the 
same range of values (1 to 8). It would have been 
possible to combine these loops and save space and 
time. Also the row number given by 2жа+2 is newly 
calculated in each line. This wastes some time. Finally, 
the same expression (p(a)*n(a)) appears three times in 
lines 270 to 290, calculated again each time it is 
required. All this shows that the program has been 
badly thought out, and needs improvement. It takes 
about two and a quarter seconds to RUN. Now see how 
much you can shave off this by using more economical 
programming techniques. 


Techniques for time-saving 

Here is the program again, but in a modified form. It 
produces exactly the same display, but in places the 
program statements are quite different: 
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The first thing you will notice is that ten lines have been 
lopped off the listing. To achieve this, a lot of 


unnecessary calculations have been removed and 
several similar statements have been neatly condensed 
into a single line. 

The two listings are identical up to line 50. All of the 
DATA has been written into this line, but it’s also been 
reorganized. This is necessary because the loops that 
load the DATA into the two arrays have been rewritten. 
There is now a single loop at lines 60 to 90, saving four 
lines. Both the price and number are READ by READ 
p,n in line 70. The DATA in line 50 must, therefore, be 
presented in this way — a price followed by a number, 
and so on. 

Lines 110 to 150 are identical to lines 160 to 220 in the 
first program, except that several of the PLOT and 
DRAW statements have been written into a single 
statement instead of three statements taking up three 
lines. The computer can deal with multiple statements 
in a single line substantially faster than with several 
separate statements, each occupying a different line. 


There is now a major change in the way the grid is filled 
with figures. At the beginning of each loop, once the 
value of a has been established by line 160, all the 
calculations necessary for that loop are carried out once 
and for all by line 170. The variables used work in the 
following way: 


TAX TABLE VARIABLES 


The program uses four variables to fix positions and carry numbers 
calculated for use in the table. 

















Variable(s Function Le 
r Fixes row number where DATA will be PRIN Ted 

b Stores product of unit price and number of 

tz items (SUB column) 

d Stores amount of tax at 15% rate 

e Stores total cost (subtotal + tax) 








Line 180 is now a lot less complicated, because all the 
calculations have already been done. It’s just a matter of 
PRINTing the correct variable in the correct position in 
the grid. If you RUN the program in its improved form, 
the display now shows the time saved by making these 
changes: 
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The changes have taken more than a quarter of a second 
off this short program, a saving of more than 12 per 
cent. You can imagine the saving in a longer program 
dealing with much more complicated numerical DATA 
or making lots of calculations for example. 

When you are writing a long program, watch out for 
any repetition in the lines. The chances are that with 
some planning you could save both RUNning time and 
memory. Any large routine that is repeated a number of 
times will be worth making into a subroutine with 
GOSUB, while any calculations that crop up frequently 
may be carried out with FN. These devices, plus the 
various loops, can all be used to speed up a program. 
Because the speed with which your programs are RUN 
is slowed down by conversion into machine code, 
savings'in BASIC are always worth considering. 








How to SAVE screen displays 

Sometimes you may write a program which produces a 
display which you would like to be able to see again 
later. With the Spectrum you don’t necessarily have to 
RUN the original program to do this. Instead, the 
direct commands: 


SAVE “display” SCREEN$ 


can be used with a cassette recorder to store a picture 
called “display” — or any other name — on tape. The 
computer will then transmit to the tape the information 
about every pixel on the screen. When you want to see 
the image again, just play back the tape as usual, but 
with these commands: 


LOAD “picture” SCREEN$ 


The computer will gradually scan across the television 
screen, PRIN Ting the pixels in exactly the same way as 
in the original display. By using this command, you can 
produce graphics directly without using program lines, 
but then store the result on tape cassette in exactly the 
same way that you would store a program. 


Problems with functions 

Two of the Spectrum’s built-in functions, SOR and 7, 
may sometimes cause problems in your programs. 
Because the square of any number is always positive, 
the function SQR cannot be used with a minus number, 
so if you are using SQR, make sure that this will not 
happen. The problem with the exponent function is less 
obvious. If you are mathematically-minded, you might 
have tried the following way of producing a number 
that is either +1 or —1 (this can be used in a program to 
produce lines or characters over the screen in an 
unpredictable way): 


RANDOM GRAPHICS WITH EXPONENTS 


oorrou 


The exponent function should produce a positive or a 
negative number, either +1 or —1 each time. In fact, it 
won't work. This is not because the maths is faulty, but 
because, like SOR, the Spectrum's exponent function 
will not work with a minus number. The answer will 
always come out positive — not much help for up-or- 
down movement. The best way to produce the effect is 
to set up a decimal figure from 0 to 0.99999999 with 
RND, and then use an IF ... THEN line to produce 
+1 ог — 1 like this: 


200 LET a=RND 
210 IF a>0.5 THEN LET a=1: IF а<=0.5 THEN 
LET a--1 


SOR used with a minus number will produce an error 
report. The exponent function with a minus number 
will not, so you may not realize at first why a program is 
RUNning oddly. 


Setting boundaries with animation 

When you start animating graphics, you may find that 
they don't behave as you wish when they reach the edge 
of the screen. Here is a program that demonstrates this 
problem: 


ANIMATION PROGRAM 
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The program animates а small flying saucer symbol 
built up from two rows each of three characters with a 
space either side. The space erases the old image of the 
saucer as the new image is drawn one space to the left or 
right of the last position. Line 40 sets the starting 
position and sets a— the change in position of the saucer 
— to 1. Line 80 sets the position for the next PRINT). 
Line 100 checks whether the saucer has reached the 
edge of the screen (c=0 or c=31) and if so, it reverses 
the saucer’s direction. Then back to line 50 to PRINT 
the new saucer: 








SPLIT CHARACTER 


But, as you can see, it doesn’t work properly. The 
saucer appears to wrap round onto the next row down 
and then retreat back up. It’s a common problem with 
animation programs. 

Line 100 deals with how the saucer behaves at the 
screen’s edges. Remember that c represents the column 
number of the first or furthest left character of the 
saucer. When the last saucer character (the furthest 
right) reaches the right edge of the screen, c has a value 
of 27, not 31. To rectify this, change line 100: 


100 ТЕ c=27 OR c=0 THEN LET а= ~а 


The program now takes into account the size of the 
object that is being animated. 


Testing for the screen edge 

The next program is similar to the previous one in that 
it moves an object around the screen, but this time the 
object is composed of only one character and it moves in 
both horizontal and vertical directions: 


EDGE-TESTER PROGRAM 





1@ BORDER 1 
20 LET г=11 LET c216 LET уга 
LET hel 
30 PRINT AT 
1 INKEYS 
+0. 
se INKEYS$="h" AND h> THEN 
LET hsh*0.1 
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IF с:31 THEN LET се21 LET 


IF rzsQ THEN LET го LET v= 


PAPER 2 INK 


LW ea 
v" AND v» THEN 


ІР ге21 THEN LET rsBi: LET 


PRINT AT г.с; "В" 
ВЕЕР O.02,60-5*r 
GO TO зо 


ө.1 

















Each time the character is erased by line 30, line 60 
changes the row and column values by v and h 
respectively. These are initially set to 1. Because of this 
and the effect of lines 70 and 80, the character bounces 
around the screen just like a ball bouncing around 
inside an empty box. 

Lines 40 and 50 allow you to change the ball’s speed. 
If you press the V key and the ball is travelling 
downwards, the variable v is increased by 0.1, 
increasing the ball’s downward speed. In the same way, 
if you press the H key and the ball is travelling to the 
right, the ball’s horizontal speed increases. But try it. 
When you press either V or H, the ball speeds towards 
the edge of the screen, and then the program throws up 
an error message — either “B Integer out of range, 
110:1” or “5 Out of screen, 110:1". If you don't touch 
the keyboard, the program RUNS correctly, proving 
that the animation lines have been written properly, but 
for some reason will not work with INKEY$. 

Consider for a moment what would happen if the ball 
was at position 20,10 and travelling downwards and to 
the right. At the same instant, you press the V key. Line 
40 increases v from 1 to 1.1. Line 60 changes r to 21.1 
and c to 11. Line 100 checks whether r equals 21. It 
doesn't. So, line 110 tries to PRINT the ball AT 
21.1,11, producing the “Out of screen" error message. 

The problem is that you can no longer predict the 
exact value of r or c when the ball reaches a screen edge. 
So, change some lines to cope with the situation and 
conditions you do know about — that is, neither г nor c 
can have values less than zero, r cannot be greater than 
21 and c cannot be greater than 31. So the lines are now: 


70 ТЕ c<0 THEN LET c=0:LET h=—h 
80 ТЕ c>31 THEN LET c=31:LET h=—h 
90 IF r<0 THEN LET r=0:LET v=—v 
100 IF r>21 THEN LET r=21:LET у--у 


Once you have made these changes, the program will 
correctly test for the edge of the screen. 


















One of the problems with BASIC is that it exists in 
many different forms or “dialects”. The Spectrum uses 
a form of BASIC which includes some commands — 
BORDER, PAPER and INK for example - that other 
machines do not have. Similarly, other micros may 
produce effects that can be achieved on the Spectrum, 
but by completely different techniques; nowhere is this 
more evident than in graphics programs. All this makes 
"program mobility" — trying to use the same program 
on different computers — very difficult. You can see this 
in software retailing where many programs are only 
available for one type of machine. 

If you do see a program in a magazine or book, or a 
friend shows you a program RUNning on another 
computer, you may decide that it's worth converting to 
RUN on your Spectrum. To do this you must know not 
only how the machines concerned differ, but also you 
must be able to understand why and how a program 
does what it does. Then you can break the program 
down into blocks or subroutines and finally look at it 
line by line. But in the same way as you can rarely 
translate a message into a foreign language word for 
word, you cannot simply translate each "foreign" 
program statement directly into the equivalent 
statement for your computer. It may be more 
economical in time and more efficient to completely 
rewrite a section of program using the best commands 
available on your machine. 


Points to watch for when converting 

One of the most variable aspects of BASIC is 
punctuation and spacing. The Spectrum's error- 
checking system will ensure that you do not ENTER 
any lines that have incorrect spelling or punctuation, 
but you don't want to have to keep experimenting until 
you get things right. Full stops, colons and semi-colons 
are used in different ways by many machines, and you 
will often need to make punctuation changes before you 
can use lines on your Spectrum. 

Remember that any text or graphics co-ordinates are 
likely to need changing. Because different computers 
often have different display resolutions, the co- 
ordinates used to produce displays can rarely be 
incorporated without alterations in converted 
programs. Making a note of the other micro’s text and 
graphics grid limits will help you here. 

When converting programs, you must always be on 
the lookout for commands that relate directly to a 
machine’s operating system, because they will have no 
meaning for the Spectrum. Similarly, commands like 
PEEK and POKE on the Spectrum cannot be used ina 
program converted for other machines, as they refer to 
the Spectrum’s memory addresses. Watch out too for 


ONVERTING PROGRAMS 











commands that use a computer clock: you will need to 
completely rewrite routines to make use of the 
Spectrum’s timing system. 

The list of these problems is quite a long one, but 
once you have tried some program conversion, you will 
soon learn what is safe "standard" BASIC, and what is 
“dialect”. It isa good idea when converting programs to 
have a look through the other computer's manual, so 
you can pick out any commands which look unfamiliar. 
If you know what these do in advance, you will find the 
process of translating a lot easier. 


Converted and original listings 
The following listing is an example of a program written 
specifically for another computer, the Acorn BBC 
Micro. It sets up a games board - a routine that you 
might want to use on your Spectrum. But it won't RUN 
on the Spectrum in its present form: 

BBC MICRO GAMES BOARD PROGRAM 





MODE? : VOUS 

PROCSCREEN 

GCOLO, 4: Y=832 

FOR ROW=1 TO 7 STEP 2 
ГЕРТ=240 ; RIGHT#=840 
PROCBOARD 

LEFT=340 ; RIGHT=940 ; Y= -BO 
PROCBOARD 

Ү=Үү-80 

NEXT ROW 

END 

DEF PROCSCREEN 

GCOLO, 129:CLG:GCOLO,6 

MOVE 240,832:MOVE 1040, 832 
PLOT 85,240,192:PLOT 85,1040, 192 
ENDPROC 

DEF PROCBOARD 

FOR X=LEFT TO RIGHT STEP 200 
MOVE X,Y:MOVE X*100,Y 

PLOT 85,х,Ү-8О 

PLOT 85,X*100,'*Y-80 

NEXT X 

ENDPROC 















































Almost everthing in this program is peculiar to the BBC 
Micro and cannot be used by the Spectrum. The BBC 
Micro’s colout commands and the way in which it calls 
special kinds of subroutines, called procedures, are 
entirely different. That’s why it is necessary to 
understand how the program works before you can start 
converting it. You will find that it is a great help if you 
can see the program RUNning rather than working 
only from a printed listing. 

The most straightforward way to convert or translate 
this program is to take each block, identify its function, 
and then write a routine that will carry out the same 
function in Spectrum BASIC. Lines 10 to 110 form the 
main program, which jumps to two subroutines called 
PROCSCREEN and PROCBOARD. These are called 
by name instead of line number. PROCSCREEN draws 
a large cyan square on a red background. The main 
program draws a row of alternately coloured squares 
across the screen (lines 50 and 60) then moves down 
(line 70) and draws a second row of squares. The second 
row is displaced to the right of the first. Four such pairs 
of rows are produced to form a chessboard. The BBC 
Micro builds each square from a pair of triangles, a 
facility not available on the Spectrum. 

You can now rewrite the program to RUN on the 
Spectrum. Because so much of the program is in BBC 
BASIC, there is nothing to be gained by trying to 
translate it line by line. Its quicker and easier to 
examine the program and then work out how the 
Spectrum could best produce the same result: 


SPECTRUM GAMES BOARD PROGRAM 
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More BASIC differences 

The next program, also written in BBC BASIC, lists ten 
names on the screen. Each name is accompanied by a 
number ~ it might be a list of the best scores for a game. 
At first sight the method looks quite familiar in that it 
uses arrays, and should be easily adaptable for the 
Spectrum: 





BBC MICRO ARRAY PROGRAM. 


»LIST 
10 ОІМ NAMESC10>:DIM_ ЗСОКЕФ!О» 
го DATA JOHN,4O0O0,ELLEN, 246,FRED,115, 
GEORGE , 341 , KATE, 692, DEBBIE, 944, JAMES, 443 
,TINA6,672, JUDITH, 195, TONY, 733 
30 FOR Не1 TO 10 
40 READ NAMES, SCORE 
NAMES CN? *NAMES : SCORE CN» SCORE 
NEXT N 
CLS 
PRINT ТАВ<10,1> "МАМЕ", "SCORE" 
PRINT TABC10, 25 "ЖЖЖЖЖЖЖЖЖЖЖЖЖЖЖ" 
FOR N=1 TO 10 





PRINT TABC10, 2%N+2>NAMESCN)D, ; SCORE 


NEXT N 











The Spectrum can produce this, but watch out for a 
typical hidden problem. The Spectrum dimensions 
arrays in a different way. The BBC's name array is 
dimensioned by: 


10 DIM NAME$(10) 


but the Spectrum requires the length of the strings to be 
specified as well: 
20 DIM N$(10,6) 
Also the strings in the Spectrum's DATA must be 
enclosed in quotation marks. Otherwise the programs 
are very similar: 

— SPECTRUM ARRAY PROGRAM 
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When you are trying to convert programs that seem to 
use Spectrum-compatible commands, be careful that 
you do not fall into the trap of assuming that they 
operate in exactly the same way. Standard words like 
DIM, INKEYS, TAB and so on, can make converting 
tricky if you do not realize that many computers use the 
same commands quite differently. 
























Although you can write, edit and RUN programs on 
screen and store them on cassette, a paper print-out is 
still the best way of examining a listing closely. A print- 
out can also let you keep the product of a program 
RUN, which is very useful if you want to look over the 
results again. So, sooner or later, you will want to add a 
printer to your system. 

'The Sinclair printer is of the thermal/electrostatic 
type. Sparks jump from a pair of moving metal needles 


onto the special aluminium-coated paper, burning off 


the aluminium in places to reveal a black ink layer 
underneath. The spark pattern, and therefore the 
character printed, is controlled by the computer. 


Printer enabling commands 

The printer is connected up to the computer by the edge 
connector on the Spectrum's back panel. When the 
printer is plugged in, it won't print anything unless you 
tell it to. PRINT statements in a program send 
characters to the television screen; the printer ignores 
them completely. 

There are several ways of getting information out to 
the printer. The program opposite enables you to see all 
of them at work, offering you a choice of the three 
printer commands. The commands are designed to 
allow you to use the printer selectively. You can either 


The ZX Printer The printer used with the Spectrum is 
controlled by three keywords that can be used in programs. 




































PRINT AT 4,8; "Е oice' 
PRINT AT 6,5;"1 To LPRINT' 
PRINT AT 8.8: "2 то LLIST" 
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Choice 
LPRINT 
LLIST 
COPY 





produce a printed version of what the program will 
PRINT, or produce a printed listing, or see a copy of the 
screen display produced on paper. 

First of all, the printer equivalent of PRINT is 
LPRINT. It is used just like PRINT but with LPRINT 
nothing appears on the screen. If you ENTER 1 with 
the program, the results of a program routine are 
directed to the printer instead. In this case, the printer 
will produce a copy of the Spectrum's character set. 

The printer's equivalent of LIST is LLIST, selected 
in the program by ENTERing 2. Again, this only works 
on the print-out, and will not produce a listing on the 
screen. 

The final method of using the printer is controlled by 
the COPY command, selected in the program by 
ENTERing 3. This makes whatever is displayed on the 
screen appear on the print-out. This is the command 
used to copy graphics displays, charts and so on. 





The grid below shows the co-ordinates of the screen The second co-ordinate sets the vertical position 
display when graphics commands are used. A point on measured from the bottom of the screen. A character 
the screen is identified by two co-ordinates x,y. The PRINTed on the screen occupies an area that is 8 
first co-ordinate sets the horizontal position which is graphics units wide and 8 graphic units high. You 
measured along from the left-hand side of the screen. cannot PRINT on the bottom two lines of the screen. 
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Character grids These grids can be used 
to design either a single character (above) 
or a symbol made from up to four 
characters (right). You can pencil in your 
design on the grids and then use the blue 
columns to list the row totals. These are 
used in a program with the commands 
POKE USR. Keys A to U are free for 
programming user-defined characters. 





Each symbol or keyword that the Spectrum uses is 
represented by a code number. There are 256 code 
numbers altogether (0-255), each of which can be 
converted into a single byte of eight binary digits. The 
letter 5 for example is specified by CHR$ 83, or CHR$ 
BIN 1010011. The computer recognizes the binary 
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OVER АТШЫ 25; 


control control 


forms of the code numbers as instructions or 
information needed to carry out programs. Codes 33 to 
126 are allocated to characters specified by the ASCII 
standard which is used by most microcomputers. The 
Spectrum's keywords and graphics symbols are 
specified by the “spare” codes outside this range. 
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GLOSSARY 


Entries in bold type are BASIC keywords. 


AND 

Allows a program to take a particular course of action 
only if two conditions are met. An extension of 

IF ... THEN. 


Array 
A collection of DATA organized so that each item is 
labelled and can be handled separately. 


AT 
Used with PRINT to place characters on the screen. 


Bar chart 
A type of graph where numerical data is represented by 
columns. | 


BASIC 

Beginners’ All-purpose Symbolic Instruction Code; 
the most commonly used high-level programming 
language. 


BEEP 

Makes the computer sound a short tone or beep, whose 
duration and pitch are determined by the numbers 
following the command. 


BIN 
Converts a number written in binary into the equivalent 
number in decimal. 


Binary 
A counting system used by computers based on only 
two numbers — 0 and 1. 


Bisection search 

A method of searching DATA for one particular item. 
The DATA is continually bisected, or divided into two, 
until the item in question is found. 


Bit 
A binary digit — 0 or І. 


BORDER 
Changes the colour of the screen’s border area. 





BRIGHT 
Turns specified characters to a brighter shade of their 
INK colour. 


Byte 
A group of eight bits. 





09641 


Chip 
A single package containing a complete electronic 
circuit. Also called an integrated circuit (IC). 


CHR$ 
Translates the number following from a character code 
into the equivalent character. 


CIRCLE 
Draws a circle of a specified size with its centre at a 
specified point on the screen. 


CLS 
Clears the text area of the screen. 





COPY 
Instructs a printer to print out a copy of the screen 
display. 


COS 


The trigonometric cosine function. 


CPU 

Central Processing Unit. Normally contained in a 
single chip called a microprocessor, this carries out the 
computer’s arithmetic and controls operations in the 
rest of the computer. 


Cursor 
A flashing symbol on the screen, showing where the 
next character will appear. 


DATA 

The computer treats whatever follows DATA as 
information that may be needed later in the program. 
Used in conjunction with READ. 


Debugging 
The process of ridding a program of errors or bugs. 


DEF FN 
Defines a function used elsewhere in a program by the 
command FN. 


DIM 

Informs the computer about the dimensions of an array 
so that the computer knows how many items the array 
contains. 


DRAW 

Draws a line in the current INK colour from the 
graphics origin at 0,0 or from the last point visited to a 
point specified. 


FLASH 
Makes characters flash on the screen. 





Flowchart 
A diagrammatic representation of the steps necessary 
to solve a problem. 


EN 

Indicates that the variable following is being used as the 
name of a function. The function must be defined by a 
DEF FN statement. 


A loop which repeats a sequence of program statements 
a specified number of times. 


GOSUB 

Makes the program jump to a subroutine beginning at 
the line number following the command. The 
subroutine must always be terminated by RETURN. 


GOTO 
Makes a program jump to the line number following 
the command. 


Hardware 

The physical machinery of a computer system, as 
distinct from the programs (software) that make it do 
useful work. 


IF ... THEN 
Prompts the computer to take a particular course of 
action only if the condition specified is detected. 


INK 


Changes the colour of text and graphics that appear on 
the screen. 


INKEY$ 
Monitors the keyboard to see if any key has been 
pressed, and if so returns the character. 


INPUT 
Instructs the computer to wait for some data from the 
keyboard which is then used in a program. 


INT 
Converts a number with decimals into a whole number. 


Interface 
The hardware and software connection between a 
computer and another piece of equipment. 


INVERSE 
Switches the PAPER colour for the INK colour and 


vice versa. 


K 
Abbreviation of kilobyte (1024 bytes). 





LEN 
Counts the total number of characters in a string that 
follows it. 


LET 
Assigns a value to a variable. 


LIST 
Makes the computer display the program currently in 
its memory. 


LLIST 
Instructs a printer to print out a listing of the program 
currently in memory. 


LOAD 
Transfers a program from a cassette tape into the 
computer's memory. 


Loop 
A sequence of program statements which is executed 
repeatedly or until a specified condition is satisfied. 


LPRINT 

Sends whatever follows the command to a printer 
instead of to the screen, so a paper copy only is 
produced. 


MERGE 

Allows a second program to be LOADed into the 
computer from a tape cassette without erasing the 
program currently in memory, as long as the line 

numbers do not coincide. 


NEW 
Removes a program from the computer's memory. 


OR 

Allowsa program to take a particular course of action if 
either of two specified conditions are met. An extension 
of IF ... THEN. 


OVER 
Allows new characters to Бе РК ПУ Ted on top of 
existing characters. 


PAPER 
Changes the screen's background colour. 


PAUSE 
Halts a program for a period set by a number measured 
in fiftieths of a second. 


PEEK 
Reports the number stored in a specified location in the 
memory. 








Peripheral 
Ап extra piece of equipment which can be added to the 
basic computer system ~ a printer, for example. 


Pie chart 

A graphic display of numerical data in the form of a 
divided circle. The size of each slice in the pie reflects 
the size of the number it represents. 


PLOT 
Makes a dot appear on the screen at the point specified. 


POINT 
Reports whether the point at the co-ordinates following 
is displayed as an INK colour or PAPER colour. 


POKE USR 

Stores a number that reprograms a key to produce a 
user-defined character. On its own, POKE puts a 
number into a specified memory location. 


PRINT 
Makes whatever follows appear on the screen. 


RAM 

Random Access Memory (volatile memory). A memory 
whose contents are erased when the power is switched 
off. (See also ROM.) 


RANDOMIZE 
Sets the point at which the fixed RND sequence will 
begin. 


READ 
Instructs the computer to take information from a 
DATA statement. 


REM 


Enables the programmer to add remarks to a program. 


The computer ignores whatever follows the commands. 


RESTORE 
Resets the point from which DATA items are READ, 
so that items can be used more than once in a program. 


RETURN 
Terminates a subroutine. (See also GOSUB.) 


RND 
Produces numbers between 0 and 1 at random. 


ROM 

Read Only Memory (non-volatile memory). A memory 
which is programmed permanently by the 
manufacturer and whose contents can only be read by 
the user’s computer. 





SAVE 
Records a program currently in the computer’s memory 
onto a tape. The program is identified by a filename. 


SCREEN$ 
Holds the details of a screen display so that they can be 
SAVEd or LOADed. 


SIN 
The trigonometric sine function. 


Software 
Computer programs. 


SQR 
Produces the square root of the number that follow: 


Statement 
An instruction in a program. There may be more than 
one statement in each program line. 


STEP 
Sets the step size ina FOR ... NEXT loop. 


STOP 
Halts a program and PRINTS out the line number in 
which it appears. 


String 
A sequence of characters treated as a single item — 
someone’s name, for instance. 


Subroutine 

A part of a program that can be called when necessary, 
to produce a particular display or carry out a number of 
calculations repeatedly, for example. 


Syntax 
Rules governing the way statements must be put 
together in computer language. 


TAB 
Used with PRINT to specify how far along a line 
characters are to appear. 


VAL 
Evaluates a number-string, and produces a number. 


Variable 

A labelled slot in the computer’s memory in which 
information can be stored and retrieved later in a 
program. 


VERIFY 
Checks that a program that is currently in memory has 
been recorded correctly on a tape cassette using SAVE. 








Main entries are in 


bold type 


Address 20-21, 56 
AND 8-9, 61 


Animation 13, 20, 44-5, 


FU! 46-7, 54-5 
А106 Array 22-3, 24, 25, 29, 
24064315527. 61 
А SCII code 12-13, 24, 
GOSUB -60 
Makes the |0» 61 
the line nu; 
subroutine 1C 5 20, 26, 52, 
с ВЕЕР 20, 21, 44-5, 47, 
61 
BIN (binary) 61 
BORDER 11, 56, 61 
BRIGHT 61 
Byte 60, 61 


Calculations 6-7, 16, 17, 


2].22;23, 25:32:38: 
38, 41, 53 
CAPS SHIFT key 6 
Cassette tape/recorder 
20, 42, 54, 62 
Character 9, 24, 27, 31, 
37, 38, 45, 46, 54, 58, 
62 


— graphics 34, 41, 55 
- grid 56, 59 
— set 60 
— user-defined 37, 38, 
41, 44, 63 
СНЕ 60, 61 
Circle 16-17, 18, 61 
Clock 20-21, 56 
CLS 50, 61 
Colour/COLOUR 34, 
35, 38, 46-7 
Co-ordinates 9, 16, 18, 


22,31, 32, 33, 37, 48-9, 


56, 59 
COPY 58, 61 


COS (cosine) 18-19, 31, 


36, 61 
Cursor 6, 34, 38, 61 


DATA 23, 28-9, 38, 
52-3, 57, 61, 63 
Debugging 14, 50-1, 61 
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DIM 22, 57, 61 

DRAW 10, 16-17, 18, 
19, 30, 33, 34, 35, 39, 
61 


E (exponent) 54 

ENTER 12, 24, 35, 42, 
46, 50-51, 58 

Error message 50-51, 


4, 


File 28, 42, 63 

Flash 61 

Flowchart 38, 62 

EN (Function) 6-7, 18, 
21, 33, 41, 53, 54, 62 

FOR ... NEXT 10, 32, 
34, 50-51, 62 

Frame counter 20-21 


Games 9, 10, 11, 15, 27, 
38-43, 46, 48 

GOSUB 51, 53,62 

GOTO 10, 20, 51, 62 


| Graphics 10-11, 16-19, 


30-43, 47, 48-9, 54—5, 
56-7, 58, 60 

- characters 48, 59 

— grid 10-11, 16, 49, 
56, 59 


Hardware 20, 58, 62 


IF ... THEN 8-9, 35, 
36, 43, 46, 54, 61, 62 

INK 11, 31, 35, 40, 
46-7, 48, 56, 61, 62, 63 

INKEY$ 12-13, 40, 55, 
57, 62 

INPUT 11, 12, 25, 31, 
33, 35, 62 

INT (integer) 6, 14, 23, 

8, 62 


INVERSE 62 
Keyboard 6, 12-13, 62 


LEFT$ 26 

LEN 25, 27, 62 
LET 51, 62 
LIST 38, 58, 62 
LLIST 58, 62 
LOAD 54, 62, 63 





DEF F FN 6-7, 61, 62. 






Loop 8-9, 10, 18, 35, 
36, 46, 52, 53, 62 
LPRINT 58, 62 


Machine code 53 
Memory 20-21, 42, 43, 

53, 56, 62, 63 
MERGE 42-3, 62 
MID$ 26 


NEW 42, 62 


Operating system 56-7 
OR 8, 62 
OVER 62 


PAPER 11,35,40,46-7, 
56, 62, 63 
PAUSE 15, 20, 25, 36, 
39, 47, 62 
PEEK 20-21, 56, 62 
PI 16-17, 31 
Pixel 31, 49, 54 
PLOT 16, 17, 18, 32, 
33, 37, 46, 53,63 
POINT 46-7, 63 
POKE 20, 56, 63 
- USR 59, 63 
PRINT 11, 22, 25, 35, 
38, 39, 40, 41, 43, 49, 
59, 61, 63 
- CHR$ 11 
Printer 20, 58, 63 
Punctuation 50, 56 


RAD (radian) 17 

RANDOMIZE 14-15, 
63 

READ 23, 25, 28, 29, 
38, 52-3, 61 

REM 40, 41, 63 

RENUMBER 51 

Resolution 31, 32, 33, 
41, 56 

RESTORE 63 

RETURN 41, 63 

RIGHTS$ 26 

RND 9, 14-15, 48-49, 
63 

RUN 14, 19, 20, 21, 32, 
37, 38, 39, 42, 45, 50- 
21922, 58, 54. 56, 57; 
58 


SAVE 39, 54, 63 
SCREENS 54, 63 








SIN (sine) 18-19, 31, 63 

Software 56, 62, 63 

Sound/SOUND 44-5 

Speed 7, 10, 15, 19, 20, 
25, 28, 35, 45, 47, 52-3 

SOR (square root) 6, 54, 
63 

STEP 10-11, 17, 19, 32, 
34, 63 

STOP 51, 63 

Subroutine 7, 10, 24, 
38, 39, 40, 47, 53, 56, 
57, 63 

SYMBOL SHIFT key 6 


TAB 57, 63 
'TO 26 


VAL 25, 63 

Variable 10, 21, 24, 25, 
35, 38, 40, 43, 44, 45, 
51, 52, 53, 55, 62, 63 
— string 24, 26—7, 28, 
50—51, 62, 63 

VERIFY 63 
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